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Introducere 


“Ce învăţătură predă Maestrul?” - 
întrebă un vizitator. 

“Nici una”, răspunse discipolul. 
“Atunci de ce ţine discursuri?” 
“El doar ne arată calea - nu ne 
învaţă nimic.” 


Anthony de Mello, O clipă de 
înţelepciune 


Oricine a folosit cel puţin o dată Internetul sau a citit o revistă de specialitate 
în domeniul informaticii, a auzit cu siguranţă cuvântul „Java“. Java reprezintă 
un limbaj de programare, creat de compania Sun Microsystems în anul 1995. 
Iniţial, Java a fost gândit pentru a îmbunătăţi conţinutul paginilor web prin adău- 
garea unui conţinut dinamic: animaţie, multimedia etc. În momentul lansării 
sale, Java a revoluţionat Internetul, deoarece era prima tehnologie care oferea 
un astfel de conţinut. Ulterior au apărut şi alte tehnologii asemănătoare (cum 
ar fi Microsoft ActiveX sau Macromedia Shockwave!), dar Java şi-a păstrat 
importanţa deosebită pe care a dobândit-o în rândul programatorilor, în primul 
rând datorită facilităţilor pe care le oferea. Începând cu anul 1998, când a apărut 
versiunea 2 a limbajului (engl. Java 2 Platform), Java a fost extins, acoperind şi 
alte direcţii de dezvoltare: programarea aplicaţiilor enterprise (aplicaţii de tip 
server), precum şi a celor adresate dispozitivelor cu resurse limitate, cum ar fi 
telefoane mobile, pager-e sau PDA-uri”. Toate acestea au reprezentat facilităţi 


l Cei care utilizează mai des Internetul sunt probabil obişnuiţi cu controale ActiveX sau cu ani- 
maţii flash în cadrul paginilor web. 

2PDA = Personal Digital Assistant (mici dispozitive de calcul, de dimensiuni puţin mai mari 
decât ale unui telefon mobil, capabile să ofere facilităţi de agendă, dar şi să ruleze aplicaţii într-un 
mod relativ asemănător cu cel al unui PC). La momentul actual există mai multe tipuri de PDA-uri: 
palm-uri, pocketPC-uri, etc. 
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noi adăugate limbajului, care a păstrat însă şi posibilităţile de a crea aplicaţii 
standard, de tipul aplicaţiilor în linie de comandă sau aplicaţii bazate pe GUP. 
Lansarea versiunii 2 a limbajului Java a fost o dovadă a succesului imens de 
care s-au bucurat versiunile anterioare ale limbajului, dar şi a dezvoltării limba- 
jului în sine, a evoluţiei sale ascendente din punct de vedere al facilităţilor pe 
care le oferă, cât şi al performanţelor pe care le realizează. 


Cum este organizată această carte? 


Având în vedere popularitatea extraordinară de care se bucură limbajul Java 
în cadrul programatorilor din întreaga lume, am considerat utilă scrierea unei 
lucrări în limba română care să fie accesibilă celor care doresc să înveţe sau 
să aprofundeze acest limbaj. Ideea care a stat la baza realizării acestei cărţi a 
fost aceea de a prezenta nu numai limbajul Java în sine, ci şi modul în care se 
implementează algoritmii şi structurile de date fundamentale în Java, elemente 
care sunt indispensabile oricărui programator cu pretenţii. Aşadar, cartea nu 
este destinată numai celor care doresc să acumuleze noţiuni despre limbajul 
Java în sine, ci şi celor care intenţionează să îşi aprofundeze şi rafineze cunoş- 
tinţele despre algoritmi şi să îşi dezvolte un stil de programare elegant. Ca o 
consecinţă, am structurat cartea în două volume: prima volum (cel de faţă) este 
orientat spre prezentarea principalelor caracteristici ale limbajului Java, în timp 
ce volumul al doilea (disponibil separat) constituie o abordare a algoritmilor din 
perspectiva limbajului Java. Finalul primului volum cuprinde un grup de cinci 
anexe, care prezintă mai amănunţit anumite informaţii cu caracter mai special, 
deosebit de utile pentru cei care ajung să programeze în Java. Am ales această 
strategie deoarece a dobândi cunoştinţe despre limbajul Java, fără a avea o ima- 
gine clară despre algoritmi, nu reprezintă un progres real pentru un programator. 
Iar scopul nostru este acela de a vă oferi posibilitatea să deveniți un programator 
pentru care limbajul Java şi algoritmii să nu mai constituie o necunoscută. 

Cele două volume cuprind numeroase soluţii Java complete ale problemelor 
prezentate. Mai este necesară o remarcă: deseori am optat, atât în redactarea co- 
dului sursă cât şi în prezentarea teoretică a limbajului sau a algoritmilor, pentru 
păstrarea terminologiei în limba engleză în defavoarea limbii române. Am luat 
această decizie, ţinând cont de faptul că mulţi termeni s-au consacrat în acest 
format, iar o eventuală traducere a lor le-ar fi denaturat înţelesul. 

Primul volum cuprinde opt capitole: 

Capitolul 1 reprezintă o prezentare de ansamblu a tehnologiei Java. Capi- 
tolul debutează cu istoria limbajului, începând cu prima versiune şi până la cea 


3GUI = Graphical User Interface, interfaţă grafică de comunicare cu utilizatorul, cum sunt în 
general aplicaţiile disponibile pe sistemul de operare Microsoft Windows. 
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curentă. În continuare, sunt înfăţişate câteva detalii despre implementările ex- 
istente ale limbajului. Implementarea Java a firmei Sun este tratată separat, în 
detaliu, fiind şi cea pe care s-au testat aplicaţiile realizate pe parcursul cărţii. 

Capitolul 2 este cel care dă startul prezentării propriu-zise a limbajului Java, 
începând cu crearea şi executarea unui program simplu. Sunt prezentate apoi 
tipurile primitive de date, constantele, declararea şi iniţializarea variabilelor, 
operatorii de bază, conversiile, instrucţiunile standard şi metodele. 

Capitolul 3 este destinat referinţelor şi obiectelor. Sunt prezentate în de- 
taliu noţiunile de referinţă, obiect, şiruri de caractere (String-uri) şi de şiruri de 
elemente cu dimensiuni variabile. 

Capitolul 4 continuă prezentarea începută în capitolul anterior, prezentând 
modul în care se pot defini propriile clase în Java şi cum se implementează 
conceptele fundamentale ale programării orientate pe obiecte. 

Capitolul 5 prezintă în detaliu un principiu esenţial al programării orientate 
pe obiecte: moştenirea. Sunt prezentate de asemenea noţiuni adiacente cum ar 
fi cea de polimorfism, interfaţă, clasă interioară, identificare a tipurilor de date 
în faza de execuţie (RTTI = Runtime Type Identification). 

Capitolul 6 este dedicat în întregime modului de tratare a excepțiilor în 
Java. Se prezintă tipurile de excepţii existente în limbajul Java, cum se pot defini 
propriile tipuri de excepţii, cum se pot prinde şi trata excepţiile aruncate de o 
aplicaţie. Finalul capitolului este rezervat unei scurte liste de sugestii referitoare 
la utilizarea eficientă a excepțiilor. 

Capitolul 7 prezintă sistemul de intrare-ieşire (I/O) oferit de limbajul Java. 
Pe lângă operaţiile standard realizate pe fluxurile de date (stream) şi fişiere 
secvențiale, este prezentată şi noţiunea de colecție de resurse (engl. resource 
bundles). 

Capitolul 8 este rezervat problemei delicate a firelor de execuție (thread- 
uri). Pornind cu informații simple despre firele de execuție, se continuă cu 
accesul concurent la resurse, sincronizare, monitoare, coordonarea firelor de 
execuție, cititorul dobândind în final o imagine completă asupra sistemului de 
lucru pe mai multe fire de execuție, aşa cum este el atât de elegant realizat în 
Java. 


Cele opt capitole ale primului volum sunt urmate de un grup de anexe, care 
conțin multe informații utile programatorilor Java. 

Anexa A constituie o listă cu editoarele şi mediile integrate pentru dez- 
voltarea aplicațiilor Java, precum şi un mic tutorial de realizare şi executare a 
unei aplicații Java simple. Tot aici este prezentată şi ant, o unealtă de foarte 
mare ajutor în compilarea şi rularea aplicaţiilor de dimensiuni mai mari. 

Anexa B este dedicată convențiilor de scriere a programelor. Sunt prezen- 
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tate principalele reguli de scriere a unor programe lizibile, conforme cu stan- 
dardul stabilit de Sun Microsystems. Ultima parte a anexei este dedicată unei 
unelte foarte utile în documentarea aplicaţiilor Java: javadoc. 

Anexa C detaliază ideea de pachete, oferind informaţii despre pachete Java 
predefinite şi despre posibilitatea programatorului de a defini propriile sale pa- 
chete. Un accent deosebit se pune şi pe prezentarea arhivelor jar . 

Anexa D prezintă modul în care se pot realiza aplicaţii internaţionalizate, 
prin care textele care apar într-o aplicaţie sunt traduse dintr-o limbă în alta, cu 
un efort minim de implementare. De asemenea, este prezentat şi rolul colecţiilor 
de resurse (engl. resource bundles) în internaţionalizarea aplicaţiilor. 

Anexa E reprezintă o listă de resurse disponibile programatorului Java, 
pornind de la site-ul Sun Microsystems şi până la tutoriale, cărți, reviste online, 
liste de discuţii disponibile pe Internet. Cu ajutorul acestora, un programator 
Java poate să îşi dezvolte aptitudinile de programare şi să acumuleze mai multe 
cunoştinţe despre limbajul Java. 


Volumul al doilea este destinat prezentării algoritmilor. Independenţa al- 
goritmilor relativ la un anumit limbaj de programare, face ca majoritatea pro- 
gramelor din această parte să fie realizate şi în pseudocod, punctând totuşi pen- 
tru fiecare în parte specificul implementării în Java. 

Capitolul 9 constituie primul capitol al celui de-al doilea volum şi prezintă 
modalitatea prin care se poate realiza analiza eficienţei unui algoritm. Notaţia 
asimptotică, tehnicile de analiză a algoritmilor, algoritmii recursivi constituie 
principala direcţie pe care se axează acest capitol. 

Capitolul 10 reprezintă o incursiune în cadrul structurilor de date utilizate 
cel mai frecvent în conceperea algoritmilor: stive, cozi, liste înlănţuite, arbori 
binari de căutare, tabele de repartizare şi cozi de prioritate. Fiecare dintre aceste 
structuri beneficiază de o prezentare în detaliu, însoţită de o implementare Java 
în care se pune accent pe separarea interfeţei structurii de date de implementarea 
acesteia. 

Capitolul 11 constituie startul unei suite de capitole dedicate metodelor 
fundamentale de elaborare a algoritmilor. Primul capitol din această suită este 
rezervat celei mai elementare metode: backtracking. După o analiză amănunţită 
a caracteristicilor acestei metode (cum ar fi cei patru paşi standard în imple- 
mentarea metodei: atribuie şi avansează, încercare eşuată, revenire, revenire 
după construirea unei soluții), sunt prezentate câteva exemple de probleme cla- 
sice care admit rezolvare prin metoda backtracking: generarea permutărilor, a 
aranjamentelor şi a combinărilor, problema damelor, problema colorării hărților. 

Capitolul 12 prezintă o altă metodă de elaborare a algoritmilor: divide er 
impera. Prima parte a capitolului este rezervată prezentării unor noţiuni intro- 
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ductive despre recursivitate şi recurenţă, absolut necesare înţelegerii modului în 
care funcţionează această metodă. Analog capitolului 11, prezentarea propriu- 
zisă a metodei este însoţită de câteva exemple de probleme clasice rezolvabile 
prin această metodă: căutarea binară, sortarea prin interclasare (mergesor?), 
sortarea rapidă (quicksort), trecerea expresiilor aritmetice în formă poloneză 
postfixată. 

Capitolul 13 prezintă cea de-a treia metodă de elaborare a algoritmilor: 
metoda Greedy. Capitolul păstrează aceeaşi structură ca şi cele precedente: 
sunt prezentate mai întâi elementele introductive ale metodei, urmate apoi de 
câteva exemple clasice de probleme rezolvabile prin această metodă: problema 
spectacolelor, minimizarea timpului de aşteptare, interclasarea optimă a mai 
multor şiruri ordonate. 

Capitolul 14 este rezervat unei metode speciale de elaborare a algoritmilor: 
programarea dinamică, ce reprezintă probabil cea mai complexă metodă de 
elaborare a algoritmilor, punând deseori în dificultate şi programatorii experi- 
mentaţi. Totuşi avem credinţa că modul simplu şi clar în care sunt prezentate 
noţiunile să spulbere mitul care înconjoară această metodă. Capitolul debutează 
cu o fundamentare teoretică a principalelor concepte întâlnite în cadrul metodei. 
Apoi, se continuă cu rezolvarea unor probleme de programare dinamică: în- 
mulţirea unui şir de matrice, subşirul comun de lungime maximă, distanţa Le- 
vensthein etc. 

Capitolul 15 reprezintă ultimul capitol din seria celor dedicate metodelor 
de elaborare a algoritmilor. Metoda branch and bound este cea abordată în 
cadrul acestui capitol, prin intermediul unui exemplu clasic de problemă: jocul 
de puzzle cu 15 elemente. 

Capitolul 16 reprezintă o sinteză a metodelor de elaborare a algoritmilor 
care au fost tratate de-a lungul volumului al doilea, prezentând aspecte comune 
şi diferenţe între metode, precum şi aria de aplicabilitate a fiecărei metode în 
parte. 


Cui se adresează această carte? 


Lucrarea de faţă nu se adresează începătorilor, ci persoanelor care stăpâ- 
nesc deja, chiar şi parţial, un limbaj de programare. Cititorii care au cunoştinţe 
de programare în C şi o minimă experienţă de programare orientată pe obiecte 
vor găsi lucrarea ca fiind foarte uşor de parcurs. Nu sunt prezentate noţiuni 
elementare specifice limbajelor de programare cum ar fi funcţii, parametri, in- 
strucţiuni etc. Nu se presupune cunoaşterea unor elemente legate de progra- 
marea orientată pe obiecte, deşi existenţa lor poate facilita înţelegerea noţiu- 
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nilor prezentate. De asemenea, cartea este foarte utilă şi celor care doresc să 
aprofundeze studiul algoritmilor şi modul în care anumite probleme clasice de 
programare pot fi implementate în Java. 


Pe Internet 


Pentru comoditatea cititorilor, am decis să punem la dispoziţia lor codul 
sursă complet al tuturor programelor prezentate pe parcursul celor două volume 
ale lucrării în cadrul unei pagini web concepută special pentru interacţiunea cu 
cititorii. De asemenea, pagina web a cărţii va găzdui un forum unde cititorii 
vor putea oferi sugestii în vederea îmbunătăţirii conţinutului lucrării, vor putea 
schimba opinii în legătură cu diversele aspecte prezentate, adresa întrebări au- 
torilor etc. Adresele la care veţi găsi aceste informaţii sunt: 


e http://www.albastra.ro/carti/v178/ 


e http://www.danciu.ro/apj]/ 


Mulţumiri 


În încheiere, dorim să adresăm mulţumiri colegilor şi prietenilor noştri care 
ne-au acordat ajutorul în realizarea acestei lucrări: Vlad Petric (care a avut o 
contribuţie esenţială la structurarea capitolului 14), Alexandru Băluţ (autor al 
anexei A), Iulia Tatomir (a parcurs şi comentat cu multă răbdare de mai multe 
ori întreaga carte) şi Raul Furnică (a parcurs şi comentat capitolele mai delicate 
ale lucrării). 
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1. Prezentarea limbajului Java 


Descoperirea constă în a vedea 
ceea ce toată lumea a văzut şi în a 
gândi ceea ce nimeni nu a gândit. 


Albert Szent-Gyorgi 


In cadrul acestui capitol vom prezenta informaţii cu caracter general care 
să vă permită realizarea unei idei de ansamblu asupra limbajului Java. Sunt 
prezentate informaţii despre următoarele subiecte: 


e De ce este important să învăţaţi Java şi de ce este Java un concurent serios 
pentru celelalte limbaje de programare; 


e Cum a fost creat limbajul Java şi care a fost evoluţia sa în anii care au 
urmat de la apariţia sa în 1995; 


e Care sunt companiile care implementează limbajul Java; 


e Prezentare detaliată a celei mai importante implementări a limbajului 
Java, cea oferită de Sun Microsystems, incluzând informaţii despre ter- 
minologia de bază utilizată; 


e Ce cuprinde platforma Java oferită de Sun Microsystems. 


1.1 Limbaje de programare 


Probabil că primul lucru la care se gândesc cei care cunosc şi alte limbaje 
de programare este la ce le foloseşte asimilarea unui nou limbaj? Nu sunt de 
ajuns cele pe care le cunosc deja? Oricât de simplu ar părea, un răspuns ferm 
la această întrebare nu este chiar atât de uşor de formulat. Deşi sunt numeroase 
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limbaje de programare în lumea calculatoarelor, între ele există multe diferenţe. 
Fiecare are avantaje şi dezavantaje în raport cu celelalte. Nu există un limbaj 
de programare perfect care să înglobeze toate avantajele oferite de limbajele 
existente. 


Deşi numărul de limbaje de programare este relativ mare, limbajele folosite 
în dezvoltarea de aplicaţii software sunt în general aceleaşi. Java face parte 
din această categorie, pentru că este un limbaj de programare remarcabil, care 
uşurează sarcina programatorilor de a realiza aplicaţii de o complexitate incredi- 
bilă. Experienţa în domeniul software a arătat că învăţarea limbajului Java poate 
să îmbunătăţească nivelul calitativ al unui programator. Pe lângă avantajele 
practice de a avea mai multe posibilităţi de a rezolva o problemă, învăţarea 
acestui limbaj poate să lărgească perspectivele şi modalităţile de abordare a 
problemelor care sunt dificil de implementat în celelalte limbaje. Să conside- 
răm de exemplu cazul în care aveţi deja experienţă de programare în C sau 
C++. Este foarte dificil să creaţi un program Java fără să înţelegeţi noţiunile 
de clase şi obiecte, spre deosebire de C++, unde se poate folosi vechiul stil de 
programare procedural, specific limbajului C. A învăţa Java presupune a învăţa 
programare orientată pe obiecte (engl. object oriented programming, pe scurt 
OOP!), ceea ce vă poate ajuta cu siguranţă să deveniți un programator mai bun. 
Iar Java oferă un înţeles mult mai clar unor concepte mai complexe, cum este 
OOP, decât reuşesc alte limbaje. De asemenea, în cazul multor probleme, veţi 
putea scrie mai rapid o soluţie în Java decât în C sau C++. Mai mult, datorită 
structurii sale, soluţia Java va fi mai puţin predispusă erorilor (vezi problemele 
spinoase cauzate de operaţiile cu pointeri). 


Lucrarea de faţă urmăreşte să vă prezinte de-a lungul capitolelor sale într- 
un mod cât mai atractiv tehnologia Java şi, totodată, să vă adâncească şi mai 
mult convingerea că acest limbaj se află printre cele care oferă cele mai pu- 
ternice facilităţi în domeniul software. lată numai câteva dintre caracteristicile 
care vor fi studiate în amănunţime: tipuri de date primitive, operatori, metode, 
referinţe, obiecte, clase, OOP, pachete, moştenire, interfeţe, clase interioare, 
RTTI (RunTime Type Identification), mecanismul reflection, excepţii, operaţii 
de intrare-ieşire (I/O), fire de execuţie, convenţii de scriere a programelor Java, 
javadoc, colecţii de resurse, aplicaţii internaţionalizate etc. 


LOOP = modalitate de a conceptualiza un program ca un set de obiecte aflate în interacţiune, 
având scopul de a îndeplini o sarcină. 
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1.2 Inceputurile limbajului Java 


Spre deosebire de alte limbaje de programare, este foarte probabil ca infor- 
maţiile pe care le aveţi despre tehnologia Java să nu fie mai vechi de câţiva ani. 
Motivul este simplu: Java a apărut doar cu câţiva ani în urmă, în 1995. 23 mai 
1995 a fost ziua în care a fost lansată oficial tehnologia care a schimbat radi- 
cal lumea calculatoarelor în cei aproape opt ani de la apariţie. În acea zi, John 
Gage, directorul departamentului "Science Office” din cadrul Sun Microsys- 
tems, şi Marc Andreessen, co-fondator şi vicepreşedinte al firmei Netscape, au 
anunţat în cadrul conferinţei SunWorld că tehnologia Java a devenit realitate şi 
că urmează să fie încorporată în Netscape Navigator, browser-ul pentru Internet 
al firmei Netscape. La acea dată, întreaga echipă de la Sun care concepuse Java 
avea mai puţin de 30 de membri. 

Începuturile limbajului Java datează însă dinainte de 1995. Tehnologia Java 
a fost creată ca o unealtă de programare în cadrul unui proiect privat de di- 
mensiuni reduse, iniţiat în cadrul companiei Sun, în anul 1991, de către un mic 
grup care îi cuprindea printre alţii pe Patrick Naughton, Mike Sheridan şi James 
Gosling. Proiectul purta numele "The Green Project” şi nu avea ca scop crearea 
unui nou limbaj de programare. Grupul, format din 13 membri, primise de la 
Sun Microsystems sarcina de a anticipa şi a plănui "noul val” în lumea tehnolo- 
giei informaţiei (engl. IT). După o perioadă de timp în care au analizat factorii 
implicaţi, concluzia membrilor grupului a fost că o tendinţă importantă în ur- 
mătorii ani urma să fie dezvoltarea dispozitivelor electrocasnice “inteligente” 
- televizoare interactive, iluminat interactiv, etc. Cercetătorii Sun considerau 
că viitorul era rezervat dispozitivelor care puteau comunica între ele, în aşa 
fel încât, de exemplu, televizorul să-i comunice telefonului mobil că a început 
emisiunea dumneavoastră preferată, iar acesta din urmă să vă alerteze printr-un 
semnal acustic. Pentru a demonstra ce văd ei ca fiind viitorul dispozitivelor 
digitale, cei 13 membri au prezentat în vara lui 1992, după 18 luni de muncă 
neîntreruptă, un dispozitiv interactiv cu interfaţă grafică, asemănător unui mic 
televizor portabil. În acea demonstraţie, de acum cunoscuta mascotă a tehnolo- 
giei Java, ducele ("The Duke”), executa câteva animații pe ecran. Prototipul era 
denumit *7 (StarSeven”) şi se remarca prin faptul că era capabil să comunice 
şi cu alte dispozitive. *7 funcţiona cu ajutorul unui limbaj cu totul nou. Ini- 
tial, ideea a fost de a realiza sistemul de operare al *7 în C++, ultrapopularul 
limbaj de programare orientat pe obiecte, dar până la urmă s-a decis crearea 
unui nou limbaj de programare, special pentru *7, care să comunice mai bine 
cu el. Limbajul a fost creat de James Gosling, membru al grupului, care l-a 
denumit “Oak” (“stejar”), după copacul din faţa ferestrei sale. Mai târziu, Sun 
a descoperit că acest nume era deja folosit pentru un alt produs şi l-a redenu- 
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mit în Java. Numele a fost ales după multe ore de gândire, dintr-o listă cu 
numeroase alte alternative. Ideea membrilor grupului era să găsească un nume 
care să cuprindă esenţa tehnologiei: vioiciune, animaţie, viteză, interactivitate 
etc. Java nu reprezenta un acronim, ci mai degrabă o amintire a acelui lucru 
fierbinte şi aromat pe care mulţi programatori îl beau în mari cantităţi (pentru 
cei care nu s-au prins, este vorba de cafea). 

Fiind proiectat pentru a fi folosit de dispozitive electrocasnice şi nu de cal- 
culatoare super-performante, Java trebuia să fie mic, eficient şi să funcţioneze 
pe o gamă largă de dispozitive hardware. De asemenea, trebuia să fie fiabil. Uti- 
lizatorii de calculatoare s-au mai obişnuit cu clasicele “căderi” ale sistemului, 
însă această situaţie nu putea fi acceptabilă pentru utilizatorii de aparatură elec- 
trocasnică (majoritatea utilizatorilor de aparatură electrocasnică au dificultăţi în 
a învăţa cum să manipuleze corect noul aparat - cum ar fi dacă acesta ar mai şi 
reacţiona uneori complet neprevăzut). 

Pe măsură ce în cadrul proiectului s-au implicat potenţiali clienţi, acesta 
a devenit public, iar grupul şi-a schimbat numele din "The Green Team” în 
"FirstPerson”. Cu timpul, echipa ”FirstPerson” a început să caute o piaţă de 
desfacere pentru dispozitivul *7, iar industria TV părea să fie cea mai potrivită 
pentru acest lucru. Echipa a creat un nou demo, denumit "MovieWood”, pen- 
tru a demonstra potenţialul tehnologiei pe piaţa dispozitivelor TV. Din păcate, 
industria televizoarelor digitale se afla în perioada de început şi proiectul nu a 
mai înaintat în această direcţie. Următorul pas a fost încercarea de a convinge 
companiile de televiziune prin cablu să utilizeze noua tehnologie. Utilizarea ei 
ar fi transformat aceste companii în adevărate reţele interactive, asemănătoare 
Internet-ului din zilele noastre, reţele în care utilizatorii ar fi putut citi sau scrie 
informaţii, dar companiile de cablu au considerat că ar putea pierde controlul 
asupra reţelelor, tentativa de promovare fiind şi de această dată sortită eşecului. 

Curând ei au realizat că noua tehnologie nu poate pătrunde în industria TV 
şi s-au decis să încerce Internetul, care la acea vreme de abia începuse să câştige 
în popularitate. Internetul reprezenta exact tipul de reţea pe care echipa îl ima- 
ginase pentru industria TV şi a televiziunilor prin cablu. Internetul devenise 
un mijloc popular de a transporta informaţii multimedia (text, imagini, filme) 
în cadrul unei reţele şi se asemăna din acest punct de vedere cu tehnologia 
Java. Deşi Internetul avea deja 20 de ani de când apăruse, fusese dificil de 
folosit până la apariţia programului Mosaic în 1993, pentru că permitea doar 
folosirea tehnologiilor ftp (FileTransferProtocol) sau telnet. Apariţia Mosaic a 
revoluţionat modul în care oamenii percepeau Internetul, deoarece avea o inter- 
faţă grafică foarte uşor de utilizat. A fost momentul în care membrii grupului au 
ajuns la concluzia că Java trebuie să devină o tehnologie destinată Internetului. 

Primul pas făcut de grup în această direcţie a fost crearea unei clone a Mo- 


20 


1.2. ÎNCEPUTURILE LIMBAJULUI JAVA 


saic, bazată pe tehnologie Java. Aplicația a fost denumită WebRunner (după 
filmul "Blade Runner”), dar a devenit oficial cunoscută sub numele de HorJava. 
Era 1994, anul apariţiei primului browser bazat pe tehnologie Java. Deşi era 
la stadiul de aplicaţie demo, HotJava era impresionant: pentru prima dată un 
browser de Internet oferea conţinut animat. La începutul anului 1995, Gosling 
şi Gage au făcut o primă prezentare publică a noului browser HotJava, care a 
avut un succes răsunător. Astfel că la începutul lunii martie 1995, versiunea alfa 
(denumită ”1.0a2”) a produsului FHotJava a devenit publică pe Internet. Codul 
sursă al aplicaţiei a fost făcut şi el public. În săptămânile care au urmat, numărul 
de download-uri al aplicaţiei HotJava a crescut impresionant, atingând 10.000 
de copii. A fost un număr care a depăşit cu mult până şi aşteptările grupului. 
Trăsăturile care au făcut Java să fie bun pentru *7 s-au dovedit a fi bune şi pentru 
Internet. Java era: 


e mic - programe de dimensiuni reduse ofereau multe facilităţi; 


e portabil - putea fi rulat pe diferite platforme (Windows, Solaris, Linux, 
etc.) fără modificări; 


e sigur - împiedica scrierea de programe care produceau pagube calcula- 
toarelor. 


Curând, Sun a realizat că popularitatea tehnologiei Java şi a grupului care o 
crease, a atins un nivel foarte ridicat şi a trecut la fapte. 

Pe 23 mai 1995, tehnologia Java a fost lansată oficial de Sun Microsystems. 
Evenimentele nu s-au oprit însă aici. În aceeaşi zi, Eric Schmidt şi George 
Paolini din cadrul Sun Microsystems împreună cu Marc Andreessen din cadrul 
Netscape au semnat înţelegerea conform căreia tehnologia Java urma să fie in- 
tegrată în omniprezentul şi omnipotentul (la acea vreme...) browser Netscape 
Navigator. Surpriza era cu atât mai mare cu cât nici membrii echipei "FirstPer- 
son" nu ştiau nimic despre tratativele dintre cele două părţi. 

Cu toate că Java şi browser-ul HotJava s-au bucurat de o mare atenţie din 
partea comunităţii Web, limbajul s-a lansat cu adevărat abia după ce Netscape 
a fost prima companie care l-a licenţiat. Imediat după prima lansare, Sun şi-a 
îndreptat eforturile de dezvoltare Java printr-o nouă sucursală: JavaSoft. De-a 
lungul anilor care au urmat, tehnologia Java a câştigat foarte mult în maturi- 
tate, iar potenţialul ei este încă enorm. Au apărut JDK-ul, applet-urile, mii de 
cărți despe tehnologia Java, arhitectura JavaBeans, Netscape Communicator, 
servlet-urile, Java Server Pages (JSP), Java Foundation Classes (JFC), compo- 
nentele Enterprise JavaBeans (EJB), comerţul electronic, precum şi implicarea 
în dezvoltarea tehnologiei Java a unor firme deosebit de importante, cum ar fi 
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IBM. Toate aceste lucruri arată cât de rapid s-a dezvoltat tehnologia Java în anii 
care au trecut de la lansarea ei oficială. Java este acum un mediu important de 
dezvoltare a aplicaţiilor. Foarte mulţi utilizatori au fost atraşi de obiectivul pe 
care această tehnologie îl are: "write once, run anywhere” (“scris o dată, rulat 
oriunde”), ceea ce tradus înseamnă că folosind tehnologia Java, acelaşi program 
devine portabil şi poate fi executat pe mai multe sisteme de operare/platforme 
(de exemplu: Windows, Linux, Mac, Solaris etc.). De la apariţia ei în mai 
1995, platforma Java a fost adoptată în industria IT mai rapid decât orice altă 
nouă tehnologie din istoria calculatoarelor. Se poate spune că Java a devenit 
limbajul, platforma şi arhitectura calcului în reţea. 


1.3 Caracteristici ale limbajului Java 


Limbajul Java se bucură de o imensă popularitate în rândul programatorilor. 
Puterea sa constă în faptul că este: 


e independent de platformă; 
e orientat pe obiecte; 
e uşor de învăţat şi de folosit în dezvoltarea de aplicaţii software; 


e disponibil gratuit, factor care a dus la rapida sa răspândire. 


Posibilitatea ca aceeaşi aplicaţie să ruleze nemodificată pe diferite platforme 
(sisteme de operare) este unul dintre cele mai semnificative avantaje pe care 
limbajul Java le are asupra altor limbaje de programare. După cum se ştie, 
atunci când se compilează un program C (sau în alt limbaj de programare), 
compilatorul transformă fişierul sursă? în cod-maşină - instrucţiuni specifice 
sistemului de operare şi procesorului pe care îl foloseşte calculatorul respectiv. 
Dacă se compilează codul sursă pe un sistem Windows, programul va rula pe 
un sistem Windows, dar nu va putea rula pe un sistem Linux. Pentru a-l rula 
pe Linux, codul sursă trebuie transferat pe Linux şi recompilat, pentru a pro- 
duce cod executabil pe noul sistem. În concluzie, pentru fiecare sistem trebuie 
produs câte un program executabil separat. Programele Java dobândesc inde- 
pendenţă din punct de vedere al sistemului de operare prin folosirea unei maşini 
virtuale? - un fel de calculator în alt calculator. Maşina virtuală preia programul 


2denumit şi cod sursă, reprezintă un set de instrucţiuni pe care un programator le introduce cu 
ajutorul unui editor de texte, atunci când crează un program 
3denumită JVM, sau interpretor Java 
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Java compilat şi transformă instrucţiunile în comenzi inteligibile sistemului res- 
pectiv. Acest program compilat (într-un format denumit bytecode*) poate rula 
pe orice platformă (sistem de operare) care posedă o maşină virtuală Java. Şi 
nu este vorba numai de PC-uri, ci şi de alte dispozitive, cum ar fi: telefoane 
mobile, PDA-uri etc. Astfel, programatorii Java nu sunt nevoiţi să creeze versi- 
uni diferite ale programelor pentru fiecare platformă pe care folosesc aplicaţia, 
deoarece maşina virtuală este cea care realizează “traducerea” necesară. Maşina 
virtuală nu adaugă un nivel nedorit între sursă şi codul-maşină, fiind indispen- 
sabilă pentru a asigura independenţa de platformă. 


Orientarea pe obiecte a limbajului Java este o caracteristică logică, ţinând 
cont de faptul că Java îşi are rădăcinile în limbajul C++, moştenind de la acesta 
majoritatea conceptelor OOP. 


Java a fost modelat foarte asemănător cu C++, majoritatea sintaxei şi a struc- 
turii obiect orientate provenind direct din acest limbaj. Pentru un programator 
C++ este foarte uşor să înveţe Java. În ciuda asemănării cu C++, noţiunile cele 
mai complexe (şi totodată cele mai mari generatoare de erori) au fost eliminate 
în Java: pointeri, aritmetică cu pointeri, gestionarea memoriei se face automat 
(şi nu de către programator). Un program Java este uşor de scris, compilat şi 
depanat. 


1.4  Implementări ale limbajului Java 
Tehnologia Java poate fi împărţită în patru componente: 


e Maşina virtuală, denumită JVM (Java Virtual Machine), interpretează 
fişierele cu extensia .class care conţin bytecode. Bytecode-ul reprezintă 
cod compilat care este procesat de un program, denumit maşină virtuală, 
spre deosebire de codul executabil normal care rulează pe maşina reală 
care dispune de un procesor hardware. Bytecode-ul este format din in- 
strucţiuni generice care vor fi apoi convertite de către maşina virtuală în 
instrucțiuni specifice procesorului. Acesta este motivul pentru care apli- 
caţiile Java sunt independente de platformă. Aplicațiile Java nu trebuie 
modificate pentru a le putea rula pe platforme diferite de cea pe care au 
fost create. Este sarcina maşinii virtuale de pe respectiva platformă să 
creeze cod executabil specific platformei. Cu alte cuvinte, o aplicaţie 


+codul maşină pentru maşina virtuală, adică instrucţiuni pe care maşina virtuală le înţelege di- 
rect. Codul sursă este compilat în bytecode, astfel încât poate fi rulat pe o maşină virtuală Java. 
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Java scrisă sub Windows poate fi rulată şi pe Linux, fără a fi necesară 
nici măcar o recompilare. Interpretarea byte-code-ului rămâne în sarcina 
maşinilor virtuale de pe cele două platforme, în cazul nostru Windows şi 
Linux. Pentru a putea rula aplicaţii Java, transformate prin compilare în 
fişiere .class, este absolut necesară o maşină virtuală. Lipsa acesteia duce 
la imposibilitatea execuţiei aplicaţiilor Java; 


e Limbajul Java propriu-zis. Limbajul Java este orientat pe obiecte şi se 
aseamănă din punct de vedere al sintaxei cu C++, simplificat însă pentru 
a elimina elementele de limbaj cauzatoare de erori de programare; 


e Un compilator care generează fişierele cu extensia .class. Sarcina com- 
pilatorului este de a crea, pornind de la programul scris în limbajul Java 
(adică, de la fişiere cu extensia .java), fişierele .class, care vor fi interpre- 
tate de maşina virtuală; 


e Biblioteca de clase Java, denumită şi Java API (engl. Application Pro- 
gramming Interface). Tehnologia Java include un set de componente pu- 
ternice şi utile, care pot fi reutilizate de programatori în aplicaţii de natură 
foarte diversă. 


Terminologia Java este uneori destul de confuză. Multe persoane, inclusiv cei 
de la Sun, folosesc termenul “Java” pentru fiecare dintre aceste componente, 
dar şi pentru tehnologia în ansamblu. Din acest motiv, înţelesul termenilor tre- 
buie adeseori desprins din context. De exemplu, atunci când cineva spune că 
rulează un program Java, prin aceasta trebuie să înţelegem că de fapt rulează un 
set de fişiere .class pe maşina virtuală JVM. 

Orice implementare a limbajului Java presupune implicit implementarea tu- 
turor celor patru componente prezentate anterior. Este şi cazul celor mai impor- 
tante implementări ale limbajului Java, realizate de două nume mari în lumea 
calculatoarelor: Sun şi IBM. Implementările oferite de cele două mari firme nu 
sunt singurele. De o importanţă mai redusă sunt: Blackdown JDK (disponibil pe 
Linux, detalii la adresa http: //www.blackdown.org), Kaffe (disponibil 
pe Linux, distribuit cu Linux-ul în sine, detalii la adresa: 
nttp://www.kaffe.org). 

Nici Microsoft nu a rămas datoare la acest capitol şi a creat propria sa im- 
plementare Java, disponibilă (evident) numai pe platformele Windows. Imple- 
mentarea poartă numele de Microsoft SDK for Java şi cuprinde un compilator 
Java şi biblioteca de clase, maşina virtuală fiind download-abilă separat. Me- 
rită semnalat aici, ca o paranteză, faptul ca această implementare a limbajului 
Java a fost obiectul unui proces între Microsoft şi Sun. După trei ani procesul 
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a luat sfârşit, în ianuarie 2001. Sentința nu a fost o surpriză pentru lumea IT, 
pentru că şansele ca Microsoft să câştige erau reduse. Motivul procesului a fost 
faptul că Microsoft a încălcat în mod intenţionat contractul cu Sun, plasând în 
mod repetat logo-ul Java deţinut de Sun pe aplicaţii software care nu satisfăceau 
standardele de compatibilitate impuse de Sun prin contractul dintre cele două 
părți. Există păreri care susţin că Microsoft nici nu a dorit să satisfacă standar- 
dul de compatibilitate, pentru că astfel produsele sale ar fi devenit disponibile şi 
pe platformele non-Microsoft. Ca rezultat al sentinţei judecătoreşti, Microsoft 
a plătit 20 de milioane de dolari companiei Sun, nu va mai primi licenţă Java, 
nu va mai putea folosi logo-ul Java şi va putea să distribuie doar versiunea 
1.1.14 a implementării Java, dar şi aceasta sub o licenţă limitată, care va ex- 
pira peste şapte ani. Ca răspuns, Microsoft încearcă să convingă dezvoltatorii 
de aplicaţii software să folosească platforma proprietară “.NET”, împreună cu 
propriul limbaj de programare C#. Rămâne de văzut însă ce succes va avea 
această platformă. 

Dintre implementările Java, cel mai frecvent utilizată este cea realizată de 
Sun, acesta fiind şi motivul pentru care o vom descrie mai detaliat în paragraful 
1.5. Există situaţii în care programatorii optează pentru implementarea IBM, 
în special în cazul în care Sun nu oferă o implementare Java pentru platforma 
dorită. Din acest motiv, se cuvine să prezentăm pe scurt şi implementarea celor 
de la IBM. 

IBM oferă implementări ale limbajului Java pentru următoarele platforme 
(în paranteze este trecută versiunea la care a ajuns implementarea): 


e AIX (versiunea 1.3); 
e Linux (versiunea 1.3); 


AS/400; 


e OS/2 (versiunea 1.3); 


OS/390 (versiunea 1.1.8); 


VM/ESA (versiunea 1.1.6); 


e Windows (versiunea 1.1.8). 


Cu excepţia implementărilor pentru Windows şi Linux, celelalte implementări 
ale IBM nu sunt disponibile la Sun (în plus faţă de IBM, Sun realizează şi o 
implementare Java pentru Solaris), aşa că dacă platforma pe care o folosiţi este 
una dintre acestea, va trebui să apelaţi la implementarea IBM corespunzătoare. 
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Un alt avantaj al implementărilor IBM este compilatorul jikes, compilatorul 
Java realizat de IBM. Acesta este mai rapid şi mai prietenos” cu utilizatorul, 
decât compilatorul oferit de Sun. 

Implementările IBM trec printr-un proces complex de validare de la re- 
alizare şi până la lansarea către publicul larg. Pentru a fi făcute publice, ele 
trebuie să fie stabile şi să treacă testul de compatibilitate al firmei Sun. 


1.5 Implementarea Sun a limbajului Java 


Platforma Java se bazează pe arhitectura de reţea şi pe ideea că aceeaşi apli- 
caţie software trebuie să ruleze pe diferite tipuri de calculatoare, dar şi pe alte 
dispozitive (de exemplu, sistemul de navigare al unui automobil). De la lansarea 
ei comercială, în mai 1995, tehnologia Java a crescut în popularitate tocmai da- 
torită portabilităţii ei. Platforma Java permite executarea aceleiaşi aplicaţii Java 
pe diferite tipuri de calculatoare. Orice aplicaţie Java poate fi uşor transmisă 
prin Internet sau prin orice tip de reţea, fără probleme de compatibilitate între 
sisteme de operare sau hardware. De exemplu, se poate rula o aplicaţie bazată 
pe tehnologie Java pe un PC, pe un calculator Macintosh, sau chiar pe anumite 
tipuri de telefoane mobile. 

Tehnologia Java permite programatorilor şi utilizatorilor să realizeze lucruri 
care înainte nu erau posibile. Prin intermediul Java, Internetul şi reţelele de 
calculatoare devin mediul natural de dezvoltare al aplicaţiilor. De exemplu, 
utilizatorii pot accesa în deplină securitate informaţii personale sau aplicaţii, 
utilizând un calculator conectat la Internet. De asemenea, ei pot accesa aplicaţii 
şi de pe un telefon mobil bazat pe tehnologie Java sau pot folosi carduri Smart, 
de dimensiunea unei cărți de credit, ca modalitate de identificare. 


1.5.1  Platformele Java 


Datorită faptului că tehnologia Java a evoluat în mai multe direcții simultan, 
Sun a grupat tehnologia Java în trei ediţii: 


e Java 2 Platform, Micro Edition (platforma J2ME); 
e Java 2 Platform, Standard Edition (platforma J2SE); 


e Java 2 Platform, Enterprise Edition (platforma J2EE). 


Fiecare dintre cele trei ediţii oferă uneltele necesare creării de aplicaţii software: 
o maşină virtuală Java adaptată resurselor fizice (memorie, procesor, etc.) ale 
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dispozitivului pe care rulează, aplicaţii utilitare pentru compilare şi executare, 
şi o bibliotecă de clase (API-ul) specializate pentru fiecare tip de dispozitiv. 

Ediţiile se adresează programatorilor care doresc să realizeze un anumit tip 
de aplicaţie software: 


e J2SE reprezintă mediul de dezvoltare al aplicaţiilor de tip client-side (care 
rulează pe maşina client, cum ar fi appleturile). J2SE este o unealtă de 
bază pentru crearea de aplicaţii sofisticate şi puternice, datorită uneltelor 
de dezvoltare şi ierarhiei de clase (APT) pe care o oferă; 


e J2FE reprezintă mediul de dezvoltare al aplicaţiilor de tipul server-side 
(care rulează pe un server si pot fi accesate de mii de clienţi simultan, cum 
ar fi servlet-urile sau Enterprise Java Beans). Tehnologia J2EE uşurează 
enorm crearea de aplicaţii internet industriale scalabile prin utilizarea 
de componente Enterprise JavaBeans standardizate, modulare şi reuti- 
lizabile, şi automatizând multe detalii de comportament ale aplicaţiei, 
oferind astfel programatorilor mai mult timp pentru a dezvolta partea lo- 
gică a aplicaţiei fără să piardă timp cu partea de infrastructură; 


e J2ME se adresează programatorilor care doresc să dezvolte aplicaţii pen- 
tru dispozitive cu resurse mai reduse decât un calculator PC obişnuit. 
Printre aceste dispozitive putem enumera: carduri Smart, pager-e, tele- 
foane mobile, PDA-uri (engl. Personal Digital Assistant), anumite tipuri 
de televizoare. 


Având în vedere faptul că fiecare dintre aceste trei ediţii presupune o imensă 
cantitate de informaţii de acumulat, lucrarea de faţă va prezenta doar tehnologia 
J2SE. 


1.5.2 Platforma J2SE (Java 2 Platform, Standard Edition) 


În 1995, când tehnologia Java a fost oficial lansată, produsul Sun care per- 
mitea crearea şi executarea programelor Java se numea JDK (Java Development 
Kit). În decembrie 1998, Sun a decis să împartă tehnologia Java în trei direcţii 
şi a fost necesară introducerea unor nume noi pentru tehnologiile nou create. 
Aşa s-a ajuns la denumirea Java 2. Prin urmare, platforma JDK a fost redenu- 
mită J2SE (Java 2 Platform, Standard Edition). Celelalte două platforme, J2EE 
si J2ME, fiind nou apărute, nu a fost necesară redenumirea lor. La momentul 
apariţiei noii denumiri, produsul JDK era la versiunea 1.2, astfel că el a fost 
redenumit la rândul său Java 2 SDK, Standard Edition, v 1.2 (SDK = Software 
Development Kit). 
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Probabil că aceste denumiri au creat deja o anumită stare de confuzie. În 
primul rând trebuie făcută diferenţa dintre platformă şi produs. Prin platformă 
se înțelege o funcţionalitate abstractă, iar prin produs se înţelege aplicaţia soft- 
ware care implementează platforma respectivă. Până în decembrie 1998, plat- 
forma Java se numea JDK, iar produsele se numeau JDK 1.0, JDK 1.1, în funcţie 
de versiunea la care ajunsese produsul. În decembrie 1998, sau altfel spus, 
începând cu versiunea 1.2 a produsului JDK, platforma a fost denumită Java 
2 Platform, Standard Edition, v 1.2 (J2SE), iar produsul a fost denumit Java 
2 SDK, Standard Edition, v 1.2 (J2SDK). Noua denumire se aplică doar pro- 
duselor JDK de la versiunea 1.2. Versiunile anterioare (JDK 1.0, JDK 1.1.x) îşi 
păstrează denumirea iniţială. Un alt lucru care trebuie remarcat este că denu- 
mirea Java 2 nu afectează denumirea maşinii virtuale, care este tot JVM, sau a 
limbajului în sine, care este tot Java. 

Aşadar, J2SDK este produsul Sun care implementează platforma abstractă 
J2SE şi care este folosit pentru dezvoltarea de aplicaţii specifice platformei 
J2SE. Produsul include uneltele de creare a programelor Java (compilator etc.) 
şi uneltele de execuţie ale acestora (interpretor, maşina virtuală etc.). Compo- 
nentele necesare pentru a executa programele Java sunt grupate sub forma unui 
subprodus, denumit Java 2 Runtime Environment, Standard Edition (J2RE). 
J2RE reprezintă mediul în care se execută aplicaţiile scrise pentru platforma 
J2SE. El este un produs Sun de sine stătător şi poate fi folosit şi fără J2SDK, 
dar în această situaţie nu se vor putea crea aplicaţii Java, ci doar rula unele deja 
create. Deci, dacă doriţi doar să executaţi aplicaţii Java, nu este obligatoriu să 
instalaţi pe calculatorul dumneavoastră produsul J2SDK, fiind de ajuns să aveţi 
J2RE. În schimb, dacă doriţi să creaţi propriile aplicaţii Java, este absolut nece- 
sar să aveţi J2SDK, pentru că J2SDK este produsul care cuprinde uneltele de 
dezvoltare a aplicaţiilor Java. 

Pentru a vă crea o imagine şi mai bună asupra noţiunii de J2SE, vom prezenta 
în continuare conţinutul acestei platforme, folosind ca exemplu versiunea curentă 
a platformei, la momentul redactării acestui paragraf (aprilie 2002). Pentru a fi 
la curent cu ultimele versiuni ale tuturor platformelor Java oferite de Sun, puteţi 
afla detalii la adresa de Internet http: //java.sun.com. 

Versiunea curentă a platformei J2SE este 1.4 şi a fost lansată în primăvara 
anului 2002. Java 2 Platform, Standard Edition v 1.4, denumirea completă a 
ultimei versiuni a platformei J2SE, este formată din: 


e Java 2 SDK, Standard Edition, v 1.4 (SDK); 
e Java 2 Runtime Environment, Standard Edition, v 1.4 (JRE); 


e Java 2 Platform, Standard Edition, v 1.4 Documentation (DOCS). 
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În continuare, vom prezenta în detaliu fiecare dintre cele trei componente ale 
J2SE. 


1.5.3 J2SDK (Java 2 SDK, Standard Edition) 


J2SDK, versiunea 1.4, este disponibilă pentru următoarele platforme (sis- 
teme de operare): Windows, Linux şi Solaris. Sun nu oferă implementări ale 
limbajului Java pentru alte sisteme de operare. Prin urmare, dacă sistemul de 
operare pe care îl folosiţi diferă de cele trei enumerate mai sus, va trebui să 
găsiţi o altă companie care să ofere o implementare a limbajului Java pentru 
platforma dumneavoastră. 

Java 2 SDK reprezintă mediul de dezvoltare pentru aplicaţii, applet-uri şi 
componente la standarde profesionale, folosind limbajul de programare Java. 
Java 2 SDK include unelte utile pentru dezvoltarea şi testarea programelor scrise 
în limbajul de programare Java şi executate pe platforma Java. Aceste unelte 
sunt proiectate pentru a fi folosite în linie de comandă (de exemplu, promptul 
MS-DOS pe Windows), cu alte cuvinte, nu au interfaţă grafică. Deşi acest 
mod de operare pare într-un fel de modă veche, el reprezintă totuşi o metodă 
foarte eficientă pentru utilizatorii obişnuiţi cu aceste aplicaţii utilitare. Cei mai 
mulţi utilizatori de PC-uri asociază utilizarea liniei de comandă cu sistemul de 
operare MS-DOS. Totuşi, uneltele oferite de J2SDK nu sunt aplicaţii create 
pentru sistemul de operare MS-DOS. De altfel, nici nu există vreo versiune de 
J2SDK/JDK destinată sistemului MS-DOS. Decizia de utilizare a aplicaţiilor 
utilitare în linie de comandă a aparţinut dezvoltatorilor de programe Java. Pe de 
altă parte, faptul că sunt folosite aplicaţii în linie de comandă pentru a compila 
programele Java, nu înseamnă că nu se pot crea aplicaţii cu interfaţă grafică. 
Din contră, mediul de dezvoltare Java oferă facilități sofisticate pentru interfaţa 
grafică, de exemplu applet-urile, Swing, AWT (Abstract Window Toolkit) sau 
JFC. Aceste componente nu vor face însă subiectul lucrării de faţă. Mai mult, 
există nenumărate editoare şi medii de programare pentru Java, care automa- 
tizează procesul compilării. O prezentare a celor mai des utilizate o veţi găsi în 
cadrul anexei A. 

După cum spuneam, produsul J2SDK oferă o multitudine de aplicaţii uti- 
litare pentru compilarea, executarea, verificarea şi managementul programelor 
Java. Dintre acestea, trei sunt cele mai importante: 


e javac, compilatorul Java. Este folosit pentru a transforma programele 
Java într-o formă care poate fi executată; 


e java, interpretorul Java. Este folosit pentru a rula programele Java com- 
pilate cu javac; 
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e appletviewer, folosit la testarea applet-urilor. Este folosit pentru a 
executa applet-urile fără a folosi un browser de Internet. Această aplicaţie 
este singura dintre aplicaţiile utilitare care oferă interfaţă grafică, deşi se 
lansează în linie de comandă ca şi celelalte unelte. 


Pe lângă aceste aplicaţii utilitare, J2SDK mai cuprinde: 
e maşina virtuală JVM; 
e biblioteca de clase (API-ul); 
e documentaţia J2SDK (disponibilă separat). 


Documentaţia J2SDK este de o importanţă covârşitoare pentru orice programa- 
tor, de aceea trebuie să insistăm mai mult asupra acestui subiect. Documentaţia 
poate fi accesată online pe site-ul firmei Sun, dar poate fi şi descărcată pentru a 
fi utilizată în cazul în care nu există o conexiune Internet disponibilă permanent 
(cu alte cuvinte, pentru utilizare offline). Sun oferă o gamă largă de documen- 
taţii: specificaţiile API, ghidul programatorului, tutoriale, cărți, etc. Cele mai 
multe dintre aceste documente sunt în format HTML (HyperTextMarkupLan- 
guage), ps (PostScript) sau pdf (PortableDataFormat). 

Specificaţia API prezintă toate clasele din biblioteca de clase pe care J2SDK 
o oferă. Tot acolo este descrisă funcţionalitatea fiecărei clase şi sunt oferite ex- 
emple de utilizare în anumite contexte. Practic, această specificaţie este docu- 
mentul cel mai utilizat de un programator Java. 

Suplimentar, cei interesaţi mai pot găsi: 


e aplicaţii demonstrative împreună cu codul sursă, disponibile în directorul 
demo al distribuţiei produsului J2SDK; 


e tutorialul Java ("The Java Tutorial”) realizat de Sun, care cuprinde sute 
de exemple complete şi poate fi descărcat de la adresa 
http: //java.sun.com/docs/books/tutorial/ 
information/download.html; 


e o listă de cărţi utile, disponibilă la adresa 
nttp://java.sun.com/docs/books. 


Informaţii complete despre documentaţia J2SDK, v 1.4 se pot afla la adresa de 
Internet: http://java.sun.com/j2se/1.4/docs/index.html. 

Pentru a obţine produsul J2SDK, trebuie să accesaţi pagina de Internet 
http://java.sun.com/]j2se. De acolo, puteţi descărca produsul com- 
patibil cu sistemul de operare pe care îl utilizaţi. Tot de acolo veţi putea descărca 
şi documentaţia J2SDK. 
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Procedura de instalare a platformei J2SDK crează o ierarhie de directoare 
care va fi detaliată în cele ce urmează. Pentru a putea verifica autenticitatea 
informaţiilor prezentate, este necesar să instalaţi J2SDK pe calculatorul dum- 
neavoastră. 

În urma instalării, distribuţia Java 2 SDK conţine: 


e aplicaţii utilitare pentru dezvoltarea de programe Java (în subdirectorul 
bin). Aceste unelte ajută programatorul să creeze, să execute, să verifice 
şi să documenteze programe scrise în limbajul Java; 


e mediul de execuţie (în subdirectorul jre), format din maşina virtuală 
Java, biblioteca de clase şi alte fişiere necesare execuţiei de programe 
scrise în limbajul Java. Acest mediu reprezintă o implementare internă 
a mediului de execuţie Java şi nu trebuie confundat cu Java 2 Runtime 
Environment (J2RE - paragraful 1.5.4). Instalarea J2SDK are ca rezul- 
tat şi instalarea J2RE (pentru a verifica acest lucru în cazul sistemului 
de operare Windows, accesaţi directorul JavaSoft, aflat în directorul 
Program Files, în cazul unei instalări standard); 


e alte biblioteci (în subdirectorul 11b), necesare uneltelor de dezvoltare 
pentru a funcţiona corect; 


e aplicaţii demonstrative (în subdirectorul demo), ca exemple de progra- 
mare în limbajul Java; 


e fişiere header C (în subdirectorul include), pentru uz intern; 


e codul sursă (în fişierul src. jar), pentru o parte a claselor care formează 
API-ul Java. Acest cod sursă este oferit de Sun doar în scopuri informa- 
tive, pentru a ajuta programatorii să înveţe limbajul de programare Java. 
Codul dependent de platformă nu este introdus în această arhivă de fişiere 
sursă. Pentru a vizualiza fişierele, trebuie să dezarhivaţi fişierul, folosind 
programul jar aflat în distribuţia J2SDK. Comanda trebuie executată în 
linie de comandă, în directorul în care se află fişierul src. jar şi arată 
astfel: 
jar xvf src.jar. 

În urma executării acestei comenzi se va crea un director src, care va 
conţine fişierele sursă. 


J2SDK reprezintă primul instrument de dezvoltare de aplicaţii care suportă 
noile versiuni ale limbajului Java, adesea cu şase luni înaintea apariţiei altui 
software de dezvoltare Java (de exemplu mediile de programare Symantec Vi- 
sual Cafe, Borland JBuilder, Metrowerks CodeWarrior, etc). 


31 


1.5. IMPLEMENTAREA SUN A LIMBAJULUI JAVA 


1.5.4 J2RE (Java 2 Runtime Environment, Standard Edition) 


Java 2 Runtime Environment este produsul prin intermediul căruia se pot 
executa aplicaţii scrise în limbajul Java. El este destinat celor care doresc să 
poată rula aplicaţii Java, fără a avea nevoie de întreg mediul de dezvoltare. Ca 
şi J2SDK, J2RE conţine maşina virtuală Java (JVM) şi biblioteca de clase care 
formează Java 2 API. Spre deosebire de J2SDK, J2RE nu conţine unelte de 
dezvoltare, cum ar fi compilatorul. 

J2RE este un produs care poate fi instalat separat, dar şi ca o componentă a 
J2SDK. J2RE poate fi obţinut la adresa: 


nttp://java.sun.com/j2se/1.4/jre/index.html 


Produsul poate fi redistribuit gratuit împreună cu o aplicaţie dezvoltată cu J2SDK, 
astfel încât utilizatorii respectivei aplicaţii să aibă o platformă Java pe care să o 
poată executa. 

Sun oferă produsul J2RE pentru următoarele platforme: Windows, Linux 
şi Solaris. Există o excepţie în cazul Windows: J2RE nu funcţionează pe plat- 
forma Windows NT 3.51. 


1.5.5 Documentaţia J2SE (Java 2 Standard Edition Docu- 
mentation) 


Documentaţia J2SE este organizată pe mai multe categorii: 


e tutorialul Java ("The Java Tutorial”), ghidul programatorilor Java, cuprin- 
zând sute de exemple funcţionale; 


e documentaţia J2SDK; 
e specificaţii ale limbajului Java şi ale maşinii virtuale JVM. 
Toate aceste documentaţii pot fi obţinute de la adresa: 


nhnttp://java.sun.com/docs/index.html 


1.5.6 Licența de utilizare a platformei J2SE 


Marea majoritate a produselor Sun pot fi obţinute şi folosite gratuit, chiar şi 
pentru uz comercial. J2SDK şi J2RE intră şi ele în această categorie. Mai mult 
decât atât, ele pot fi redistribuite gratuit, cu condiţia de a fi însoţite de o aplicaţie. 
Fiecare produs are propria lui licenţă de utilizare, deci, dacă doriți amănunte 
despre acest lucru, puteţi verifica separat licenţa pentru fiecare produs. 
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Rezumat 


Deşi aţi parcurs doar primul capitol al cărţii, aţi acumulat totuşi o serie de 
informaţii despre istoria limbajului Java, principalele versiuni ale limbajului 
Java existente pe piaţă la ora actuală, şi, nu în ultimul rând, v-aţi familiarizat 
cu terminologia specifică. Din moment ce noţiunile de JDK, J2SE, javac, 
java vă sunt clare, putem trece la următoarea etapă a iniţierii în tainele acestui 
limbaj. Pentru aceasta trebuie să vă instalaţi mediul de programare Java şi pe 
calculatorul dumneavoastră. În momentul în care toate uneltele de dezvoltare a 
aplicaţiilor Java (editoare, compilatoare, interpretoare) sunt la îndemâna dum- 
neavoastră, vom putea realiza primele programe Java. 


Noţiuni fundamentale 


API: set de clase utile oferite împreună cu limbajul Java, în vederea reuti- 
lizării lor de către programatori; 

J2RE: produs ce cuprinde toate aplicaţiile ce permit rularea programelor 
Java. Reprezintă o componentă a J2SDK; 

J2SDK: implementare a platformei abstracte J2 SE, cu ajutorul căreia se 
pot crea aplicaţii Java; 

J2SE: platformă abstractă pentru crearea de aplicaţii Java de tipul client- 
side; 

java: interpretorul Java ce rulează aplicaţiile Java compilate cu javac 
sau jikes; 

javac: compilator Java realizat de Sun Microsystems; 

JDK: vechea denumire a J2 SDK, utilizată până în decembrie 1998; 

jikes: compilator Java realizat de IBM; 

JVM: maşina virtuală Java, ce interpretează fişierele de tip .class. 


Erori frecvente 


1. J2SDK este confundat deseori cu J2 SE. Deşi diferenţa dintre ele nu este 
foarte uşor de sesizat, totuşi ea există. J2SE reprezintă o platformă ab- 
stractă (adică o specificaţie, un standard) în timp ce J2 SDK este o imple- 
mentare a platformei abstracte, este unealta cu ajutorul căreia se crează 


programele Java obişnuite. Până în decembrie 1998, J2 SDK a fost cunos- 
cut sub denumirea JDK. 
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2. Noţiuni fundamentale de progra- 
mare în Java 


Nu sunt nici deosebit de inteligent 
şi nici nu am vreun talent 
remarcabil. 

Sunt doar foarte, foarte curios. 


Albert Einstein 


Prima parte a cărţii va prezenta, pe parcursul a opt capitole, caracteristi- 
cile esenţiale ale limbajului Java. Nu vom include aici descrierea bibliote- 
cilor suplimentare care nu sunt esenţiale pentru înţelegerea limbajului, cum 
ar fi clasele grafice (AWT, Swing) sau appletr-urile. De asemenea, tehnologii 
J2EE avansate, precum NI, RMI, JDBC, nu sunt prezente nici ele, deoarece 
descrierea fiecăreia ar necesita cel puţin un volum separat. 

După ce în primul capitol aţi făcut cunoştinţă cu universul Java şi v-aţi 
familiarizat cu terminologia specifică, capitolul de faţă va începe prezentarea 
limbajului Java prin discutarea tipurilor primitive, a operaţiilor elementare, a 
instrucţiunilor de decizie şi iterative, a metodelor etc. 

În acest capitol vom afla despre: 


e Tipurile primitive ale limbajului Java, inclusiv operaţiile care se pot rea- 
liza cu variabile de tipuri primitive; 


e Cum sunt implementate instrucţiunile de decizie (condiţionale) şi cele 
iterative în Java; 


e Noţiuni elementare despre metode şi supraîncărcarea metodelor. 
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2.1 Mediul de lucru Java 


Cum sunt introduse, compilate şi rulate programele Java? Răspunsul de- 
pinde, evident, de platforma concretă pe care lucraţi. Anexa A vă pune la dis- 
poziţie detalii referitoare la modul de instalare a mediului de lucru Java pentru 
diverse sisteme de operare. 

Aşa cum am arătat deja în primul capitol, codul sursă Java este conţinut în 
fişiere text care au extensia . java. Compilatorul, care este de obicei javac 
sau jikes!, compilează programul şi generează fişiere .class care conţin 
bytecode. Bytecode este un limbaj intermediar portabil care este interpretat de 
către maşina virtuală Java, lansată prin comanda java. Detalii despre compi- 
latoarele şi interpretorul (maşina virtuală) Java, inclusiv modul de utilizare, se 
află tot în anexa A. Pentru programele Java, datele de intrare pot să provină din 
diverse surse: 


e de la terminal, numit aici standard input; 


e parametri suplimentari precizaţi la invocarea programului - parametri în 
linia de comandă; 


e o componentă GUI (Graphical User Interface); 


e un fişier. 


2.2 Primul program Java 


În această secţiune vom vedea Java în acţiune, prin crearea şi rularea primei 
aplicaţii scrisă în acest limbaj de programare. Să începem prin a examina pro- 
gramul simplu din Listing 2.1. Acest program tipăreşte un scurt mesaj pe ecran. 
Numerele din stânga fiecărei linii nu fac parte din program. Ele sunt furnizate 
doar pentru o mai uşoară referire a secvenţelor de cod. 


Listing 2.1: Un prim program simplu 


1 // Primul program 
2 public class FirstProgram 


3 { 


4 public static void main(String[] args) 
5 { 
6 


System .out.println ("Primul meu program Java"); 


l javac este compilatorul realizat de Sun, jikes este compilatorul realizat de IBM şi este 
preferat de mulți programatori deoarece este mult mai rapid. 
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7 ) 
s) 


Transpuneţi programul într-un fişier cu numele FirstProgram. java? 


după care compilaţi-l şi rulaţi-l. Acest lucru se realizează astfel: 


e executaţi comanda următoare în directorul în care este salvat fişierul sursă 
FirstProgram. java (folosiţi un command prompt de tipul Windows 
MS-DOS Prompt): 


javac FirstProgram. java 


e dacă execuţia comezii anterioare s-a realizat fără erori, executaţi comanda 
următoare în acelaşi director: 


java FilrstProgram 


Rezultatul execuţiei programului este afişarea mesajului "Primul meu pro- 
gram Java". Este important de reţinut că Java este case-sensitive, ceea ce 
înseamnă că face deosebirile între literele mari şi mici. 


2.2.1 Comentarii 


In Java există trei tipuri de comentarii. Prima formă, care este moştenită de 
la limbajul C începe cu /* şi se termină cu * /. lată un exemplu: 


1/* Acesta este un comentariu 
2pe doua linii */ 


Comentariile nu pot fi imbricate, deci nu putem avea un comentariu în inte- 
riorul altui comentariu. 

Cea de-a doua formă de comentarii este moştenită de la limbajul C++ şi 
începe cu //. Nu există simbol pentru încheiere, deoarece un astfel de comen- 
tariu se extinde automat până la sfârşitul liniei curente. Acest comentariu este 
folosit în linia 1 din Listing 2.1. 

Cea de-a treia formă este asemănătoare cu prima doar că începe cu /** în 
loc de /*. Acestă formă de comentariu este utilizată pentru a furniza informaţii 
utilitarului javadoc, prezentat pe larg în anexa B. 

Comentariile au fost introduse pentru a face codul mai lizibil pentru progra- 
matori. Un program bine comentat reprezintă un semn al unui bun programator. 


? Atenţie la literele mari şi mici, deoarece compilatorul Java face distincţie între majuscule şi 
minuscule! 
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2.2.2 Funcția main 


Un program Java constă dintr-o colecţie de clase care interacționează între 
ele prin intermediul metodelor. Echivalentul Java al unei proceduri sau funcţii 
din Pascal sau C este metoda statică, pe care o vom descrie puţin mai târziu în 
acest capitol. Atunci când se execută un program Java, maşina virtuală va căuta 
şi invoca automat metoda statică având numele main. Linia 4 din Listing 2.1 
arată că metoda main poate fi opţional invocată cu anumiţi parametri în linia 
de comandă. Tipul parametrilor funcţiei main cât şi tipul funcţiei, void, sunt 
obligatorii. 


2.2.3 Afişarea pe ecran 


Programul din Listing 2.1 constă dintr-o singură instrucţiune, aflată la linia 
6. Funcţia printiln reprezintă principalul mecanism de scriere în Java, fiind 
echivalent într-o anumită măsură cu funcţia writeln din Pascal sau printf 
din C. În această situaţie se scrie un şir de caractere la fluxul de ieşire standard 
System.out. Vom discuta despre citire/scriere mai pe larg în cadrul capi- 
tolului 7. Deocamdată ne mulţumim doar să amintim că aceeaşi sintaxă este 
folosită pentru a scrie orice fel de entitate, fie că este vorba despre un întreg, 
real, şir de caractere sau alt tip. 


2.3 Tipuri de date primitive 


Java defineşte opt tipuri primitive de date, oferind în acelaşi timp o foarte 
mare flexibilitate în a defini noi tipuri de date, numite clase. Totuşi, în Java 
există câteva diferenţe esenţiale între tipurile de date primitive şi cele definite 
de utilizator. În această secţiune vom examina tipurile primitive şi operaţiile 
fundamentale care pot fi realizate asupra lor. 


2.3.1 Tipurile primitive 


Java are opt tipuri de date primitive prezentate în Tabela 2.1. 

Cel mai des utilizat este tipul întreg specificat prin cuvântul cheie int. Spre 
deosebire de majoritatea altor limbaje de programare, marja de valori a tipurilor 
întregi nu este dependentă de maşină”. Java acceptă şi tipurile întregi byte, 


3 Aceasta înseamnă că indiferent pe ce maşină rulăm programul nostru (fie că este un super- 
computer dotat cu 64 de procesoare, sau un simplu telefon mobil), variabilele de tip int vor fi 
reprezentate pe 32 de biţi, lucru care nu este valabil pentru alte limbaje de programare cum ar fi C 
sau C++. 
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short şi long, fiecare fiind adecvat pentru stocare de date întregi având a- 
numite limite. Numerele reale (virgulă mobilă) sunt reprezentate în Java prin 
tipurile float şi double. Tipul double are mai multe cifre semnficative, de 
aceea utilizarea lui este recomandată în locul tipului float. Tipul char este 
folosit pentru a reprezenta caractere. Un char ocupă în Java 16 biţi (şi nu doar 
8, cum s-ar aştepta programatorii C sau Pascal, obişnuiţi cu caractere ASCII) 
pentru a putea reprezenta toate caracterele din standardul Unicode. Acest stan- 
dard conţine peste 30.000 de caractere distincte care acoperă principalele limbi 
scrise (inclusiv limbile japoneză, chineză etc.). Prima parte a tabelei Unicode 
este identică cu tabela ASCII, deci setul de caractere Unicode este o extensie 
a mai vechiului set de caractere ASCII. Ultimul tip primitiv al limbajului Java 
este boolean; o variabilă de tip boolean poate lua una din valorile de adevăr 
true sau false. 


Tabela 2.1: Cele 8 tipuri primitive de date în Java 


virgulă mobilă pe 64 biţi | 15 cifre semnificative (10 “24 la 
10308) 


char caracter unicode 


variabilă booleană false şi true 


2.3.2 Constante 


Constantele întregi pot fi reprezentate în bazele 10, 8 sau 16. Notaţia octală 
este indicată printr-un 0 nesemnificativ la început, iar notația hexa este indicată 
printr-un 0x sau 0X la început. lată reprezentarea întregului 37 în câteva moduri 
echivalente: 37, 045, 0x25. Notaţiile octale şi hexazecimale nu vor fi utilizate 
în această carte. Totuşi trebuie să fim conştienţi de ele pentru a folosi O-uri la 
început doar acolo unde chiar vrem aceasta. 

O constantă caracter este cuprinsă între apostrofuri, cum ar fi a’. In- 
tern, Java interpretează această constantă ca pe un număr (codul Unicode al 
caracterului respectiv). Ulterior, funcţiile de scriere vor transforma acest număr 
în caracterul corespunzător. Constantele caracter mai pot fi reprezentate şi în 
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forma: 
TNUXXXX!. 


unde xxxx este un număr în baza 16 reprezentând codul Unicode al carac- 
terului. 

Constantele de tip şir de caractere sunt cuprinse între ghilimele, ca în "Pri- 
mul meu program Java". Există anumite secvenţe speciale, numite sec- 
vente escape, care sunt folosite pentru anumite caractere speciale. Noi vom 
folosi mai ales 


dn a y d SA Aa PO Au ENEE. 


care înseamnă, respectiv, linie nouă, backslash, apostrof şi ghilimele. 


2.3.3 Declararea şi inițializarea tipurilor primitive în Java 


Orice variabilă Java, inclusiv cele primitive, este declarată prin descrierea 
numelui, a tipului şi, opțional, a valorii inițiale. Numele variabilei trebuie să 
fie un identificator. Un identificator poate să conțină orice combinație de litere, 
cifre şi caracterul underscore (liniuţa de subliniere “_”). Identificatorii nu pot 
începe cu o cifră. Cuvintele rezervate, cum ar fi int nu pot fi identificatori. Nu 
pot fi utilizați nici identificatorii care deja sunt declarați şi sunt vizibili. 

Java este case-sensitive, ceea ce înseamnă că sum şi Sum reprezintă iden- 
tificatori diferiţi. Pe parcursul acestei cărți vom folosi următoarea convenţie 
pentru numele variabilelor: 


e toate numele de variabilă încep cu literă mică, iar cuvintele noi din cadrul 
numelui încep cu literă mare. De exemplu: sumaMaxima, nodVizi- 
tat, numberOofStudents etc.; 


e numele claselor începe cu literă mare. De exemplu: Arithmetic- 
Exception,FirstProgram,BinaryTree etc. 


Pentru detalii complete asupra convențiilor vă recomandăm anexa B, unde veţi 
găsi informaţii despre convențiile de scriere a programelor Java, precum şi de- 
spre o aplicaţie foarte utilă oferită de Sun, şi anume javadoc, care permite 
foarte uşor crearea unor documentaţii ale programelor dumneavoastră. 

Iată câteva exemple de declaraţii de variabile: 
1 int numarElemente ; 
2 double mediaGenerala; 


sint produs = 1, suma = Q0; 
int produsi = produs; 
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O variabilă este bine să fie declarată imediat înainte de a fi folosită. Asa 
cum vom vedea mai târziu, locul unde este declarată determină domeniul de 
vizibilitate şi semnificaţia ei. 

Limbajul Java permite şi definirea de constante. Deoarece acestea necesită 
cunoştinţe mai aprofundate, ne rezumăm la a spune că ele vor fi prezentate în 
cadrul subcapitolului destinat atributelor statice. 


2.3.4  Citire/scriere la terminal 


Scrierea la terminal în Java se realizează cu funcţia println şi nu pune 
probleme majore. Lucrurile nu stau deloc la fel cu citirea de la tastatură, care 
se realizează mult mai anevoios. Acest lucru se datorează în primul rând fap- 
tului că programele Java nu sunt concepute pentru a citi de la tastatură. În 
imensa majoritate a cazurilor, programele Java îşi preiau datele dintr-o interfață 
grafică (Applet-urile), din forme HTML (Java Servlets, Java Server Pages) sau 
din fişiere, fie că sunt fişiere standard (fişiere text, binare etc.) sau colecţii de 
resurse (resource bundles). 


Citirea şi scrierea de la consolă sunt realizate prin metodele readLine, 
respectiv print In. Fluxul de intrare standard este System. in, iar fluxul de 
ieşire standard este System.out. 


Mecanismul de bază pentru citirea/scrierea formatată foloseşte tipul String, 
care va fi descris în capitolul următor. La afişare, operatorul + concatenează 
două String-uri. Pentru tipurile primitive, dacă parametrul scris nu este de 
tip String se face o conversie temporară la String. Aceste conversii pot fi 
definite şi pentru obiecte, aşa cum vom arăta mai târziu. Pentru citire se asoci- 
ază un obiect de tipul BufferedReader cu System. in. Apoi se citeşte un 
String care va fi ulterior prelucrat. Capitolul 7 vă va edifica mai mult asupra 
acestor operaţii. 


2.4 Operatori de bază 


Această secţiune descrie operatorii de bază care sunt disponibili în Java. 
Aceşti operatori sunt utilizaţi pentru a crea expresii. O constantă sau o vari- 
abilă reprezintă o expresie, la fel ca şi combinaţiile de constante şi variabile cu 
operatori. O expresie urmată de simbolul ; reprezintă o instrucțiune simplă. 
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2.4.1 Operatori de atribuire 


Programul simplu din Listing 2.2 ilustrează câţiva operatori Java. Opera- 
torul de atribuire este semnul egal (=). De exemplu, în linia 12, variabilei a i se 
atribuie valoarea variabilei b (care în acel moment are valoarea 7). Modificările 
ulterioare ale variabilei b nu vor afecta variabila a. Operatorii de atribuire pot 
fi înlănţuiţi ca în următorul exemplu, atribuirile făcându-se (asociindu-se) de la 
dreapta la stânga: 


Z= y =% = 0: 


Un alt operator de atribuire este += al cărui mod de utilizare este ilustrat 
în linia 18. Operatorul += adaugă valoarea aflată la dreapta (operatorului) la 
variabila din stânga. Astfel, valoarea lui b este incrementată de la 7 la 11. Java 
oferă şi alți operatori de atribuire cum ar fi -=, *= şi /= care modifică variabila 
aflată în partea stângă prin scădere, înmulțire şi respectiv împărţire. 


Listing 2.2: Program care ilustrează anumiţi operatori simpli 


1/xx* Utilizarea operatorilor. */ 
2 public class OperatorTest 


3 
{ 
4 public static void main(String [] args) 
5 

{ 
6 int a = 5, b=7, c= 4; 
7 
8 System . out. println("a=" + a); //a=5 
9 System . out. println("b=" + b); //b=7 
10 System . out. println ("c=" + c); //c=4 
11 
12 a = b: 
13 
14 System . out. println("a=" + a); //a=7 
15 System . out. println ("b=" + b); //b=7 
16 System . out. println ("c=" + c); //c=4 
17 
18 b += c; 
19 
20 System . out. println ("a=" + a); //a=7 
21 System . out. println ("b=" + b); //b=]1]1 
22 System . out. println ("c=" + c); //c=4 
23 
24 c = a + b; 
25 
26 System . out. println("a=" + a); //a=7 
27 System . out. println ("b=" + b); //b=]1l1 
28 System . out. println ("c=" + c); //c=18 
29 
30 C++; 
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32 System . out. println("a=" + a); //a=7 
33 System . out. println ("b=" + b); //b=11 
34 System . out. println ("c=" + c); //c=19 
35 

36 ++a ; 

37 

38 System.out.printiln("a=" + a); //a=8 
39 System . out. println ("b=" + b); //b=11 
40 System . out. println ("c=" + c); //c=19 
41 

42 b = ++a + c++; 

43 

44 System . out. println("a=" + a); //a=9 
45 System . out. println ("b=" + b); //b=28 
46 System . out. println ("c=" + c); //c=20 


2.4.2 Operatori aritmetici binari 


Linia 24 din Listing 2.2 ilustrează unul dintre operatorii binari tipici ai lim- 
bajelor de programare: operatorul de adunare (+). Operatorul + are ca efect 
adunarea conținutului variabilelor a şi b; valorile lui a şi b rămân neschimbate. 
Valoarea rezultată este atribuită lui c. Alți operatori aritmetici folosiți în Java 
sunt: —, *, / şi % utilizaţi respectiv pentru scădere, înmulțire, împărțire şi rest. 

Împărțirea a două valori întregi are ca valoare doar partea întreagă a rezulta- 
tului. De exemplu 3/2 are valoarea 1, dar 3 . 0/2 are valoarea 1.5, deoarece 
unul dintre operanzi (3.0) a fost o valoare în virgulă mobilă, şi astfel rezultatul 
întregii expresii este convertit la virgulă mobilă. 

Aşa cum este şi normal, adunarea şi scăderea au aceeaşi prioritate. Această 
prioritate este mai mică decât cea a grupului format din înmulţire, împărțire şi 
rest; astfel 1 + 2 * 3 are valoarea 7. Toţi aceşti operatori sunt evaluaţi de 
la stânga la dreapta (astfel 3 - 2 - 2 are valoarea —1). Toţi operatorii arit- 
metici au o anumită prioritate şi o anumită asociere (fie de la stânga la dreapta, 
fie de la dreapta la stânga, descrisă în Tabela 2.24). 


2.4.3 Operatori aritmetici unari 


In plus faţă de operatorii aritmetici binari care necesită doi operanzi, Java 
dispune şi de operatori unari care necesită doar un singur operand. Cel mai 


4Prin asociere înţelegem ordinea de evaluare într-o expresie care conţine operatori de acelaşi tip 
şi nu are paranteze (de exemplu, a — b — c). 
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cunoscut operator unar este operatorul minus (—) care returnează operandul cu 
semn opus. Astfel, —x este opusul lui x. 

Java oferă de asemenea operatorul de autoincrementare care adaugă 1 la 
valoarea unei variabile, notat prin ++, şi operatorul de autodecrementare care 
scade 1 din valoarea variabilei, notat cu —-—. Un caz banal de utilizare a acestor 
operatori este exemplificat în liniile 30 şi 36 din Listing 2.2. În ambele cazuri 
operatorul ++ adaugă 1 la valoarea variabilei. În Java, ca şi în C, orice expresie 
are o valoare. Astfel, un operator aplicat unei variabile generează o expresie cu 
o anumită valoare. Deşi faptul că variabila este incrementată înainte de execuţia 
următoarei instrucţiuni este garantat, se pune întrebarea: "Care este valoarea 
expresiei de autoincrementare dacă ea este utilizată în cadrul unei alte expresii?" 

În acest caz, locul unde se plasează operatorul ++ este esenţial. Semnficaţia 
lui ++x este că valoarea expresiei este egală cu noua valoare a lui x. Acest 
operator este numit incrementare prefixată. În mod analog, x++ înseamnă că 
valoarea expresiei este egală cu valoarea originală a lui x. Acesta este numit 
incrementare postfixată. Aceste trăsături sunt exemplificate în linia 42 din List- 
ing 2.2. Atât a, cât şi c sunt incrementate cu 1, iar b este obţinut prin adunarea 
valorii incrementate a lui a (care este 9) cu valoarea iniţială a lui c (care este 
19). 


2.4.4 Conversii de tip 


Operatorul conversie de tip, numit în jargonul programatorilor şi operatorul 
de cast, este utilizat pentru a genera o variabilă temporară de un nou tip. Să 
considerăm, de exemplu, secvenţa de cod: 


1 double rest; 

2 int x = 2; 

sint y = 5; 

arest = x / y; //probabil incorect! 


La efectuarea operaţiei de împărţire, atât x cât şi y fiind numere întregi, 
se va realiza o împărţire întreagă şi se obţine 0. Întregul O este apoi convertit 
implicit la double astfel încât să poată fi atribuit lui rest. Probabil că intenţia 
noastră era aceea de a atribui lui rest valoarea 0.4. Soluţia este de a converti 
temporar pe x sau pe y la double, pentru ca împărţirea să se realizeze în 
virgulă mobilă. Acest lucru se poate obţine astfel: 


rest = (double) x / y; 


De remarcat că nici x şi nici y nu se schimbă. Se crează o variabilă tempo- 
rară fără nume, având valoarea 2.0, iar valoarea ei este utilizată pentru a efectua 
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împărțirea. Operatorul de conversie de tip are o prioritate mai mare decât opera- 
torul de împărţire, de aceea conversia de tip se efectuează înainte de a se efectua 
împărţirea. 


2.5 Instrucţiuni condiţionale 


Această secţiune este dedicată instrucţiunilor care controlează fluxul de ex- 
ecuţie al programului: instrucţiunile condiţionale şi iteraţia. 


2.5.1 Operatori relaţionali 


Testul fundamental care poate fi realizat asupra tipurilor primitive este com- 
parația. Comparaţia se realizează utilizând operatorii de egalitate/inegalitate şi 
operatorii de comparaţie (<, > etc.). În Java, operatorii de egalitate/inegalitate 
sunt == respectiv !=. De exemplu, 


exprStanga == exprDreapta 


are valoarea true dacă exprStanga şi exprDreapta sunt egale, altfel are 
valoarea false. Analog, expresia: 


exprStanga != exprDreapta 


are valoarea true dacă exprStanga şi exprDreapta sunt diferite; 
altfel are valoarea false. 

Operatorii de comparaţie sunt <, <=, >, >= iar semnificaţia lor este cea na- 
turală pentru tipurile fundamentale. Operatorii de comparaţie au prioritate mai 
mare decât operatorii de egalitate. Totuşi, ambele categorii au prioritate mai 
mică decât operatorii aritmetici, dar mai mare decât operatorii de atribuire. Ast- 
fel, veţi constata că în cele mai multe cazuri folosirea parantezelor nu va fi nece- 
sară. Toţi aceşti operatori se evaluează de la stânga la dreapta, dar cunoaşterea 
acestui lucru nu ne foloseşte prea mult. De exemplu, în expresia a < b < 6, 
prima comparaţie generează o valoare booleană, iar a doua expresie este greşită, 
deoarece operatorul < nu este definit pentru valori booleene. Paragraful următor 
descrie cum se poate realiza acest test în mod corect. 


2.5.2 Operatori logici 


Java dispune de operatori logici care sunt utilizaţi pentru a simula operatorii 
and, or şi not din algebra Booleană. Aceşti operatori sunt referiţi uneori şi sub 
numele de conjuncție, disjuncție şi, respectiv, negare, simbolurile corespunză- 
toare fiind &&, | | şi !. Implementarea corectă a testului din paragraful anterior 
este: 
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(a < b) && (b < 6) 


Prioritatea conjuncției şi a disjuncției este suficient de mică față de priori- 
tatea celorlalți operatori din expresie pentru ca parantezele să nu fie necesare. 
&& are prioritate mai mare decât | |, iar ! are aceeaşi prioritate cu alți operatori 
unari (++, —-—, vezi Tabela 2.2). 


Tabela 2.2: Operatori Java listaţi în ordinea priorității 


Stânga la dreapta 
++- ! - (tip) Dreapta la stânga 
< <= > >= instanceof 


DI ee 
Dope LI 
Ress | mo 


Condițional 


Atribuire 


O regulă importantă este că operatorii && şi | | folosesc evaluarea booleană 
scurtcircuitată?. Aceasta înseamnă că dacă rezultatul poate fi determinat eva- 
luând prima expresie, a doua expresie nu mai este evaluată. De exemplu, în 
expresia: 


x != 0 && 1/x != 3 


dacă x este 0, atunci prima jumătate este false. Aceasta înseamnă că 
rezultatul conjuncţiei va fi fals, deci a doua expresie nu mai este evaluată. 
Acesta este un detaliu important, deoarece împărţirea la 0 ar fi generat un com- 
portament eronat. 


Numită uneori şi evaluare booleană parţială. 
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2.5.3 Operatori la nivel de bit 


Operatorii la nivel de bit pe care limbajul Java îi pune la dispoziţia progra- 
matorului se împart în două grupe: 


e operatori de deplasare (shiftare): >> << >>> 
e operatori logici: & | ^ ~ 
Fie că fac parte din prima sau a doua categorie, operatorii la nivel de bit nu pot 
fi utilizaţi decât în cazul numerelor întregi (variabile de tipul byte, short, 
int şi long). De fapt, operatorii se aplică reprezentării binare a numerelor 
implicate. Cu alte cuvinte, dacă avem operaţia 5 & 3, aceasta înseamnă că de 
fapt operatorul & se aplică reprezentării în baza 2 a numerelor 5 şi 3, adică 101 
şi 11. 

Prima grupă de operatori la nivel de bit, cea a operatorilor de deplasare, exe- 
cută manipularea biților primului operand, deplasându-i la stânga sau la dreapta, 
în funcţie de tipul operatorului (vezi Tabela 2.3). 


Tabela 2.3: Operatori la nivel de bit pentru deplasare 


>> opl >>op2 | deplasarea biţilor lui opl la dreapta 
IN Ia 7 ii ii 

<< opl<<op?2 | deplasarea biţilor lui opl la stânga 
A T Po iai 


> fr Apr opl >>> op2 | deplasarea biţilor lui opl la dreapta 
cu op2 poziţii, opl fiind considerat 
unsigned 


Fiecare operator deplasează biții operandului din stânga cu un număr de po- 
Ziţii indicat de operandul din dreapta. Deplasarea se face în sensul indicat de o- 
perator (>> la dreapta, iar << la stânga). De exemplu, următoarea instrucţiune 
deplasează biții numărului 5 la dreapta cu o poziţie: 


DSa că 


Reprezentarea binară a numărului 5 este 101. Prin deplasarea biţilor la 
dreapta cu o poziţie se obţine numărul care are reprezentarea binară 10, deoarece 
primul 1 (cel din stânga) trece cu o poziţie mai la dreapta, deci în locul lui 0, 
care trece cu o poziţie mai la dreapta, deci în locul celei de-a doua cifre 1, 
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care se pierde. Biţii din stânga care au rămas descompletaţi se completează 
cu 0, ceea ce conduce la rezultatul final 010. Astfel, am obţinut numărul 2 în 
reprezentarea zecimală. 

În concluzie, 5 >> 1 = 2. După cum se poate observa, pentru numerele 
pozitive, deplasarea la dreapta cu op2 biţi este echivalentă cu împărţirea lui 
op1 la 2°P?, Pentru exemplul nostru, 5/21 = 2. 

Analog se întâmplă şi în cazul deplasării la stânga. Instrucţiunea următoare 
deplasează biții numărului 5, la stânga, cu o poziţie: 


D e le 


Rezultatul deplasării biţilor 101 la stânga cu o poziţie este 1010, adică 
numărul 10 în reprezentare zecimală. Acest lucru este echivalent cu înmulţirea 
cu 2%P2. În cazul nostru, 5 +21 = 10. 

Cel de-al treilea tip de deplasare a biţilor, >>>, este asemănător cu >>, cu 
specificarea că numărul op1 este considerat fără semn (unsigned). 


Cea de-a doua categorie de operatori la nivel de bit realizează operaţii logice 
ŞI, SAU, SAU EXCLUSIV (XOR) şi NEGARE: 


Tabela 2.4: Operatori pentru operaţii logice la nivel de bit 


opl & op2 ŞI la nivel de biţi 
Ie opl | op2 SAU la nivel de biţi 


opl ^op2 | SAU EXCLUSIV la nivel de biți 
NEGARE la nivel de biți 


Să presupunem că avem două numere, 5 şi 3, cărora dorim să le aplicăm 
operații logice la nivel de biți. Operaţiile logice la nivel de biți constau în apli- 
carea operației respective perechilor de biți de pe poziții egale în cele două 
numere (cu excepția operației de negare care este unară). În situația în care nu- 
merele nu au reprezentarea binară de aceeaşi lungime, reprezentarea mai scurtă 
este completată cu zerouri nesemnificative (inserate în fața reprezentării), până 
se obțin dimensiuni egale. 

Prezentate pe scurt, operațiile logice pe perechi de biți se realizează pe baza 
următorului alogritm: 
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e expresia bl & b2 are valoarea 1, dacă şi numai dacă b1 şi b2 au va- 
loarea 1 (b1 şi b2 sunt 2 biţi, care pot lua, evident, doar valorile O şi 1). 
Altfel, expresia are valoarea 0; 


e expresia bl | b2 are valoarea 0, dacă şi numai dacă b1 şi b2 au valoa- 
rea 0. Altfel, expresia are valoarea 1; 


e expresia bl ^ b2 are valoarea 1, dacă şi numai dacă unul dintre ope- 
ranzi este 0, iar celălalt 1. Altfel, expresia are valoarea 0; 


e expresia ~b1 reprezintă negarea lui b1, deci are valoarea 1, dacă b1 este 
O, sau are valoarea 0, dacă b1 este 1. 


Iată câteva exemple de utilizare: 


101 EE S 
& 011 [f = 5 


001 // =1 


101 // = 
PRE e e Mea ff = 3 


LA // = 1 


101 // =S 
Ol IIE 


ELO // = 6 


e 5 = -6 
= 6 ARDERE 6 du // = 5 
da cae OIO // = -6 
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Această operaţie necesită anumite precizări. După cum am văzut ante- 
rior, un număr de tip int este reprezentat pe 32 de biţi. Cu alte cuvinte, 
reprezentarea numărului 5 în baza 2, are de fapt 32 de cifre binare, dintre 
care 29 sunt zerouri nesemnificative (cele din faţă), pe care le-am omis 
până acum din motive de spaţiu. La o operaţie de negare, toate zerourile 
nesemnificative ale reprezentării binare devin 1 şi capătă astfel importanţă 
(primul bit este bitul de semn, care se modifică şi el). Pentru a înţelege 
mai bine modul în care se reprezintă numerele întregi în memorie vă re- 
comandăm lucrarea [Boian]. 


2.5.4 Instrucţiunea if 


Instrucţiunea if este instrucţiunea fundamentală de decizie. Forma sa sim- 
plă este: 
1 if (expresie) 
2 instructiune 


3 
a urmatoarealnstructiune 


Dacă expresie are valoarea true atunci se execută instructiune; 
în caz contrar, instructiune nu se execută. După ce instrucţiunea if se 
încheie fără incidente (vezi cazul excepțiilor netratate, în capitolul 6), controlul 
este preluat de urmatoarealnstructiune. 

Opţional, putem folosi instrucţiunea i f-e1se după cum urmează: 


1 if (expresie) 


2 instructiunel 
3 else 
4 instructiune? 


5 
6 urmatoarealnstructiune 


In acest caz, dacă expresie are valoarea true, atunci se execută ins- 
tructiunel; altfel se execută instructiune2. In ambele cazuri con- 
trolul este apoi preluat de urmatoareaInstructiune. lată un exemplu: 


1 System .out.println("1/x este: "); 
2if (x != 0) 

3 System.out.print( 1/x ); 

4 else 

5 System .out.print("Nedefinit"); 
6 

7 System. out. println (); 


De reţinut că doar o singură instrucţiune poate exista pe ramura de if sau 
de else indiferent de cum indentaţi codul. Iată două erori frecvente pentru 
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începători: 


1if (x == 0) ; //instructiune vida!!! 

2 System . out. println("x este 0"); 

3 else 

4 System . out. print("x este"); 

5 System . out. println (x); //instructiune in afara clauzei else 


Prima greşeală constă în a pune ; după if. Simbolul ; reprezintă în sine 
instrucțiunea vidă, ca o consecință, acest fragment de cod nu va fi compilabil 
(else nu va fi asociat cu nici un if). După ce am corectat această eroare, 
rămânem cu o eroare de logică: ultima linie de cod nu face parte din if, deşi 
acest lucru este sugerat de indentare. Pentru a rezolva această problemă vom 
utiliza un bloc în care grupăm o secvență de instrucțiuni printr-o pereche de 
acolade: 


if (x == 0) 
2 | 


3 System . out. println("x este 0"); 


7 System . out. print("x este"); 
8 System . out. println (x); 


Practic, prin cuprinderea mai multor instrucțiuni între acolade, creăm o sin- 
gură instrucțiune, numită instrucțiune compusă. Aşadar, instructiunel 
(ca şi instructiune2) poate fi o instrucțiune simplă sau o instrucțiune com- 
pusă. Instrucţiunile compuse sunt formate dintr-o succesiune de instrucţiuni 
(simple sau compuse) cuprinse între acoloade. Această definiţie permite imbri- 
carea instrucţiunilor compuse în cadrul altor instrucţiuni compuse. În exemplul 
anterior, pe ramura if avem o instrucţiune compusă formată doar dintr-o sin- 
gură instrucţiune simplă: 


A 


2 System.out.printin("x este 0"); 


3) 


Am folosit aici o instrucţiune compusă deşi, fiind vorba de o singură in- 
strucţiune simplă, acest lucru nu era absolut necesar. Totuşi, această practică 
îmbunătăţeşte foarte mult lizibilitatea codului şi vă invităm şi pe dumneavoas- 
tră să o adoptați. 

Instrucţiunea if poate să facă parte dintr-o altă instrucţiune if sau else, 
la fel ca şi celelalte instrucţiuni de control prezentate în continuare în această 
secţiune. 
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2.5.5 Instrucţiunea while 


Java, ca şi Pascal sau C, dispune de trei instrucțiuni de ciclare (repetitive): 
instrucţiunea while, instrucţiunea do şi instrucţiunea for. Sintaxa instrucţiunii 
while este: 

1 While (expresie) 
2 instructiune 


3 
a urmatoarealnstructiune 


Observaţi că, la fel ca şi la instrucţiunea if, nu există ; în sintaxă. Dacă 
apare un ; după while, va fi considerat ca instrucţiune vidă. 

Cât timp expresie este true se execută instructiune; apoi ex- 
presie este evaluată din nou. Dacă expresie este false de la bun în- 
ceput, atunci instructiune nu va fi executată niciodată. În general, in- 
structiune face o acţiune care ar putea modifica valoarea lui expresie; 
altfel, ciclarea s-ar putea produce la infinit. Când execuţia instrucţiunii while 
se încheie, controlul este preluat de urmatoarealnstructiune. 


2.5.6 Instrucţiunea for 


Instrucţiunea while ar fi suficientă pentru a exprima orice fel de ciclare. 
Totuşi, Java mai oferă încă două forme de a realiza ciclarea: instrucţiunea for 
şi instrucţiunea do. Instrucţiunea for este utilizată în primul rând pentru a 
realiza iteraţia. Sintaxa ei este: 

ı for (initializare ; test; actualizare) 
2 instructiune 


3 
4aurmatoarealnstructiune 


În această situaţie, initializare, test şiactualizare sunt toate 
expresii, şi toate trei sunt opţionale. Dacă test lipseşte, valoarea sa implicită 
este true. După paranteza de închidere nu se pune ;. 

Instrucţiunea for se execută realizând mai întâi initializare. Apoi, 
cât timp test este true se execută instructiune, iar apoi se execută 
actualizare. Dacă initializare şi actualizare sunt omise, in- 
strucţiunea for se va comporta exact ca şi instrucţiunea while. 

Avantajul instrucţiunii for constă în faptul că se poate vedea clar marja pe 
care iterează variabilele contor. 

Următoarea secvenţă de cod afişează primele 100 numere întregi pozitive: 

ı for (int i = 1; i < 100; ++i) 
2 { 
Sl 
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3 System . out. println (i); 


4) 


Acest fragment ilustrează şi practica obişnuită pentru programatorii Java (şi 
C++) de a declara un contor întreg în secvenţa de iniţializare a ciclului. Durata 
de viaţă a acestui contor se extinde doar în interiorul ciclului. 

Atât initializare cât şi actualizare pot folosi operatorul virgulă 
pentru a permite expresii multiple. Următorul fragment ilustrează această tehnică 
frecvent folosită: 


for (i = 0, sum =0; i <= n; i++, sum += n) 


3 System.out.printin(i + "\t" + sum); 


Ciclurile pot fi imbricate la fel ca şi instrucţiunile if. De exemplu, putem 
găsi toate perechile de numere mici a căror sumă este egală cu produsul lor 
(cum ar fi 2 şi 2, a căror sumă şi produs este 4) folosind secvenţa de cod de mai 
Jos: 


ı for (int i = 1; i <= 10; i++) 

2 | 

3 for (int j = 1; j <= 10; j++) 

4 { 

5 if (i + j == i * j) 

6 { 

7 System . out. println(i + ", " + j); 
8 

9 


2.5.7 Instrucţiunea do 


Instrucţiunea while realizează un test repetat. Dacă testul este true 
atunci se execută instrucțiunea din cadrul ei. Totuşi, dacă testul inițial este 
false, instrucțiunea din cadrul ciclului nu este executată niciodată. În anu- 
mite situații avem nevoie ca instrucțiunile din ciclu să se execute cel puțin o 
dată. Acest lucru se poate realiza utilizând instrucțiunea do. Instrucţiunea do 
este asemănătoare cu instrucțiunea while, cu deosebirea că testul este realizat 
după ce instrucțiunile din corpul ciclului se execută. Sintaxa sa este: 


ı do 

2 instructiune 

3 while (expresie); 

4 
surmatoarealnstructiune; 
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Remarcaţi faptul că instrucţiunea do se termină cu ;. Un exemplu tipic în 
care se utilizează instrucțiunea do este dat de fragmentul de (pseudo-) cod de 
mai jos: 

1 do 
2 { 


3 afiseaza mesaj; 
4 citeste data; 


5} 
6 while (data nu este corecta); 

Instrucţiunea do este instrucţiunea de ciclare cel mai puţin utilizată. Totuşi, 
când vrem să executăm cel puţin o dată instrucţiunile din cadrul ciclului, şi for 
este incomod de utilizat, atunci do este alegerea potrivită. 


2.5.8 Instrucţiunile break şi continue 


Instrucţiunile for şi while au condiţia de terminare înaintea instrucţiu- 
nilor care se repetă. Instrucţiunea do are condiţia de terminare după instrucţi- 
unile care se repetă. Totuşi, în anumite situaţii, s-ar putea să fie nevoie să în- 
trerupem ciclul chiar în mijlocul instrucţiunilor care se repetă. În acest scop, 
se poate folosi instrucţiunea break. De obicei, instrucţiunea break apare în 
cadrul unei instrucţiuni if, ca în exemplul de mai jos: 


1 while (...) 
24 
3 se 
4 if (conditie) 
5 { 

6 break ; 
î 

8 

9 


) 


În cazul în care sunt două cicluri imbricate, instrucţiunea break părăseşte 
doar ciclul cel mai din interior. Dacă există mai mult de un ciclu care trebuie 
terminat, break nu va funcţiona corect, şi mai mult ca sigur că aţi proiectat 
prost algoritmul. Totuşi, Java oferă aşa numitul break etichetat. În acest caz, 
o anumită instrucţiune de ciclare este etichetată şi instrucțiunea break poate fi 
aplicată acelei instrucţiuni de ciclare, indiferent de numărul de cicluri imbricate. 
Iată un exemplu: 


eticheta: 
while (...) 


While (...) 
{ 


1 
2 
3 
4 
5 
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{ 


10 ) 
11 ) 
12 ) 


13 // controlul programului trece aici dupa executia lui break 


6 ie 
7 if (conditie) 
8 
9 


break eticheta; 


În anumite situaţii dorim să renunţăm la execuţia iteraţiei curente din ciclu 
şi să trecem la următoarea iteraţie a ciclului. Acest lucru poate fi realizat cu 
instrucțiunea continue. Ca şi break, instrucţiunea continue este urmată 
de ; şi se aplică doar ciclului cel mai interior în cazul ciclurilor imbricate. 
Următorul fragment tipăreşte primele 100 de numere întregi, cu excepţia celor 
divizibile cu 10: 

ı for (int i = 1; i <= 100; i++) 


2 { 


3 if (i % 10 == 0) 

4 { 

5 continue ; 

6 ) 

A 

8 System.out.printin(i); 


Desigur, că exemplul de mai sus poate fi implementat şi utilizând un if 
simplu. Totuşi instrucţiunea continue este adeseori folosită pentru a evita 
imbricări complicate de tip if-else în cadrul ciclurilor. 


2.5.9 Instrucţiunea switch 


Instrucţiunea switch este numită uneori şi instrucțiune de selecție; ea are 
rolul de a selecta dintre mai multe secvenţe de cod, una care va fi executată, 
funcţie de valoarea unei expresii întregi. Forma sa este: 


1 switch (expresie—selectare) 


2 { 


3 case valoare—intreagal : 
4 instructiune; 

5 break; 

6 case valoare—intreaga?2: 
7 instructiune; 

8 break; 

9 

10 IL ases 

11 

12 case valoare—intreagaN : 
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13 instructiune; 
14 break; 

15 

16 default: 

17 instructiune; 


expresie-selectare este o expresie care produce o valoare întreagă. 
Instrucţiunea switch compară valoarea expresiei expresie-selectare 
cu fiecare valoare-intreaga. Dacă are loc egalitatea, se execută instrucţi- 
unea corespunzătoare (simplă sau compusă). Dacă nu are loc nici o egalitate 
se execută instrucţiunea din default (alternativa default este opţională în 
cadrul switch). 

Observaţi că în exemplul de mai sus, fiecare case se încheie cu un break 
care are ca efect saltul la sfârşitul instrucţiunii switch. Acesta este modul 
obişnuit de a scrie o instrucţiune de tip switch, dar prezenţa instrucţiunii 
break nu este obligatorie. Dacă instrucţiunea break lipseşte, atunci se va 
executa şi codul corespunzător instrucţiunilor case următoare până când se în- 
tâlneşte un break. Deşi de obicei nu ne dorim un astfel de comportament, el 
poate fi uneori util pentru programatorii experimentați. 

Pentru a exemplifica instrucţiunea switch, programul din Listing 2.3 cre- 
ază litere aleator şi determină dacă acestea sunt vocale sau consoane (în limba 
engleză). 


Listing 2.3: Program care exemplifică instrucţiunea switch 


// VowelsAndConsonants . java 
// Program demonstrativ pentru instructiunea switch 
public class VowelsAndConsonants 


{ 


public static void main(String [] args) 


{ 


for (int i = 0; i < 100; i++) 


{ 


— 


© © A A a AA ù N 


char c = (char) (Math.random () + 26 + 'a)); 


10 System.out.print(c +": "); 
11 switch (c) 

12 { 

13 case ’°a’ 

14 case `e’ 

15 case ’°i?’ 

16 case ’°o’ 

17 case 'u': 

18 System . out. println ("vocala"); 
19 break; 

20 case °y’: 

21 case °w: 
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22 System . out. println ("Uneori vocale "); 
23 //doar in limba engleza! 

24 break; 

25 default: 

26 System . out. println ("consoana"); 

27 } // switch 

28 } // for 

29 } // main 


323 } //class 


Funcția Math.random () generează o valoare în intervalul [0,1). Prin în- 
mulțirea valorii returnate de această funcție cu numărul de litere din alfabet (26 
litere) se obține un număr în intervalul [0,26). Adunarea cu prima literă ('a”, 
care are de fapt valoarea 97, codul ASCII al literei 'a”) are ca efect transpunerea 
în intervalul [97,123). În final se foloseşte operatorul de conversie de tip pen- 
tru a trunchia numărul la o valoare din mulţimea 97, 98, ..., 122, adică un cod 
ASCII al unui caracter din alfabetul englez. 


2.5.10 Operatorul condiţional 


Operatorul condițional este folosit ca o prescurtare pentru instrucțiuni sim- 
ple de tipul if-else. Forma sa generală este: 


exprTest ? expresieDa : expresieNu; 


Mai întâi se evaluează expr Test urmată fie de evaluarea lui expresieDa 
fie de cea a lui expresieNu, rezultând astfel valoarea întregii expresii. ex- 
presieDa este evaluată dacă exprTest are valoarea true; în caz contrar 
se evaluează expresieNu. Prioritatea operatorului condițional este chiar dea- 
supra operatorilor de atribuire. Acest lucru permite omiterea parantezelor atunci 
când asignăm rezultatul operatorului condițional unei variabile. Ca un exemplu, 
minimul a două variabile poate fi calculat după cum urmează: 


valMin = x< y? xXx : y; 


2.6 Metode 


Ceea ce În alte limbaje de programare numeam procedură sau funcție, în 
Java este numit metodă. O definiție completă a noțiunii de metodă o vom da 
mai târziu, când vom introduce noțiunile de clasă şi obiect. În acest paragraf 
prezentăm doar câteva noţiuni elementare pentru a putea scrie funcţii de genul 
celor din C sau Pascal pe care să le folosim în câteva programe simple. 
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Listing 2.4: Declararea şi apelul unei metode 


public class Minim 
{ 


1 

2 

3 public static void main( String[] args ) 

a f{ 

5 int a = 3 ; 

6 int b = 7 ; 

7 System . out. println ( "Minimul este: " + min(a,b) ) ; 
s o} 

9 


10 // declaratia metodei min 
u public static int min( int x, int y ) 


2 ë f{ 


13 return x<y?x:y ; 


14 } 


Antetul unei metode constă dintr-un nume, o listă (eventual vidă) de pa- 
rametri şi un tip pentru valoarea returnată. Codul efectiv al metodei, numit 
adeseori corpul metodei, este format dintr-o instrucțiune compusă (o secvență 
de instrucțiuni cuprinsă între acolade). Definirea unei metode constă în antet şi 
corp. Un exemplu de definire şi utilizare a unei metode este dat în programul 
din Listing 2.4. 

Prin prefixarea metodelor cu ajutorul cuvintelor cheie public static 
putem mima într-o oarecare măsură funcțiile din Pascal şi C. Deşi această tehnică 
este utilă în anumite situaţii, ea nu trebuie utilizată în mod abuziv. 

Numele metodei este un identificator. Lista de parametri constă din 0 sau 
mai mulţi parametri formali, fiecare având un tip precizat. Când o metodă este 
apelată, parametrii actuali sunt trecuţi în parametrii formali utilizând atribuirea 
obişnuită. Aceasta înseamnă că tipurile primitive sunt transmise utilizând ex- 
clusiv transmiterea prin valoare. Parametrii actuali nu vor putea fi modificaţi de 
către funcţie. Definirile metodelor pot apărea în orice ordine. 

Instrucţiunea return este utilizată pentru a întoarce o valoare către codul 
apelant. Dacă tipul funcţiei este void atunci nu se întoarce nici o valoare. În 
anumite situaţii, pentru ieşirea forţată dintr-o metodă care are tipul void se 
foloseşte return; fără nici un parametru. 


2.6.1  Supraîncărcarea numelor la metode 


Să presupunem că dorim să scriem o metodă care calculează maximul a trei 
numere întregi. Un antet pentru această metodă ar fi: 


57 


2.6. METODE 


int max(int a, int b, int c) 


În unele limbaje de programare (Pascal, C), acest lucru nu ar fi permis dacă 
există deja o funcție max cu doi parametri. De exemplu, se poate să avem deja 
declarată o metodă max cu antetul: 


int max(int a, int b) 


Java permite supraîncărcarea (engl. overloading) numelui metodelor. A- 
ceasta înseamnă că mai multe metode cu acelaşi nume pot fi declarate în cadrul 
aceleiaşi clase atâta timp cât semnăturile lor (adică lista de parametri) diferă. 
Atunci când se face un apel al metodei max, compilatorul poate uşor să deducă 
despre care metodă este vorba examinând lista parametrilor de apel. Se poate 
să existe metode supraîncărcate cu acelaşi număr de parametri formali, atâta 
timp cât cel puţin unul din tipurile din lista de parametri este diferit. 

De reţinut faptul că tipul funcţiei nu face parte din semnătura ei. Aceasta 
înseamnă că nu putem avea două metode în cadrul aceleiaşi clase care să difere 
doar prin tipul valorii returnate. Metode din clase diferite pot avea acelaşi nume, 
parametri şi chiar tip returnat, dar despre aceasta vom discuta pe larg mai târziu. 


Rezumat 


În acest capitol am discutat despre noţiunile fundamentale ale limbajului 
Java, cum ar fi tipurile primitive, operatorii, instrucţiunile conditionale şi repeti- 
tive, precum şi metode, care se regăsesc în aproape orice limbaj de programare. 

Totuşi, orice program nebanal presupune utilizarea tipurilor neprimitive, nu- 
mite tipuri referinţă, care vor fi discutate în capitolul următor. 


Noţiuni fundamentale 


break: instrucţiune prin care se iese din cel mai din interior ciclu iterativ 
sau din cadrul instrucţiunii switch. 

comentarii: au rolul de a face codul mai lizibil pentru programatori, dar nu 
au nici o valoare semantică. Java dispune de trei tipuri de comentarii. 

continue: instrucţiune prin care se trece la următoarea iteraţie din cadrul 
ciclului iterativ în care este folosită. 

do: instrucţiune repetitivă în care ciclul repetitiv se execută cel puţin o dată. 

for: instrucţiune repetitivă utilizată mai ales pentru iteraţie. 

identificator: nume dat unei variabile sau unei metode. 

if: instrucţiune de decizie. 
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instrucţiune compusă: mai multe instrucţiuni cuprinse între acolade şi care 
formează astfel o singură instucțiune. 

main: metodă specială în cadrul unei clase, care este apelată la execuţia 
aplicaţiei. 

metodă: echivalentul Java al unei funcţii. 

metodă de tip static: metodă echivalentă cu o metodă globală. 

operator condiţional (?  :): operator folosit ca o prescurtare a secvențe- 
lor simple if...else. 

operatori aritmetici binari: utilizaţi pentru operaţii aritmetice de bază, 
cum arfi +,-,*,/ şi 5. 

operatori de atribuire: operatori utilizaţi pentru modificarea valorii unei 
variabile. Exemple de operatori de atribuire sunt =, +=, -=, *=, /=. 

operatori de egalitate: sunt == şi !=. Ei întorc fie true fie false. 

operatori de incrementare şi decrementare: operatori care adaugă, res- 
pectiv scad, o unitate la/din valoarea curentă a variabilei. Există două forme 
incrementare şi decrementare: prefixat şi postfixat. 

operatori logici: &&, | | şi !, folosiţi pentru a reprezenta conceptele de 
disjuncţie, conjuncţie şi negare din algebra booleană. 

operatori relaţionali: <, >, <=, >= sunt folosiţi pentru a decide care din 
două valori este mai mică sau mai mare; rezultatul lor este true sau false. 

return: instrucţiune utilizată pentru a returna informaţii către instrucţi- 
unea care a apelat metoda. 

semnătura unei metode: este formată din combinaţia dintre numele me- 
todei şi tipurile din lista de parametri. Tipul valorii returnate nu face parte din 
semnătură. 

switch: instrucţiune if generalizată. 

tipuri întregi: byte, short, intşi long. 

tipuri primitive: formate din tipurile întregi, virgulă mobilă, boolean şi 
caracter. 

while: instrucţiune iterativă. 


Erori frecvente 


1. Adăugarea neintenţionată a simbolului ; imediat după instrucţiunile for, 
while conduce la erori logice greu de detectat, deoarece instrucțiunile 
care se presupune că ar face parte din ciclurile respective, sunt de fapt în 
afara ciclului, motiv pentru care se vor executa o singură dată. În reali- 
tate, ; reprezintă instrucţiunea vidă, şi este tratată de compilator ca orice 
altă instrucţiune. 
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PA 


O metodă care în antet declară că trebuie să returneze o valoare, dar în 
corpul de definire nu face acest lucru, conduce la apariţia unei erori de 
compilare. 


. Pentru operaţii logice ŞI/SAU se folosesc && şi | |, şi nu operatorii & şi 


. Adăugarea unui 0 în faţa unui număr, transformă numărul respectiv în 


baza 8. De exemplu, dacă numărului 37, îi adăugăm un 0, obţinând 037, 
acesta devine reprezentarea în baza 8 a unui alt număr, 31. 


. Pentru compararea valorilor stocate în variabile, folosiţi == şi nu =. De 
exemplu, if (a == 0) este corect, în timp ce if (a = 0) nu este 
corect şi compilatorul va semnala o eroare (în loc de boolean a găsit 
int). 


. Nu stocați într-o variabilă o valoare mai mare/mică decât limitele per- 


mise. De exemplu, dacă într-o variabilă de tip byte, care poate stoca 
valori între -128 şi 127, se încearcă stocarea valorii 128, atunci vom avea 
o depăşire (overflow), situație în care numărul trece de la o extremă la 
alta, adică -128, şi va continua numărătoarea de acolo. Situațiile de de- 
păşire a intervalului admis sunt greu de depistat într-un program, de aceea 
este indicat să vă alegeţi un tip de variabilă care să ofere spaţiul necesar 
de stocare (de exemplu, int sau long). 


. Clauza else aparţine de cea mai apropiată instrucţiune if. Dacă dorim 


să asociem clauza else cu o instrucţiune if deschisă anterior, trebuie 
instrucţiunile din cadrul acelui if să fie cuprinse între acolade, ca în ex- 
emplul de mai jos: 


ı if (a>0) 

2 { 

3 if(b>0) 

4 c = a+b ; 

5} 

6 else //else va fi asociat cu if(a>0) 
7 C = a*b ; 


. Numele clasei Java trebuie să fie acelaşi cu numele fişierului sursă care o 


conține; atenție la litere mari şi mici! 


. Lipsa instrucţiunii break pe ramurile logice ale instrucţiunii switch 


duce la apariţia unui efect nedorit în cele mai multe cazuri: de la ramura 
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curentă se trece la cea următoare care este şi ea executată. Ca o consecinţă 
se execută mai multe ramuri din cadrul instrucţiunii switch. 


Exerciţii 


Pe scurt 


l. 


2. 


10. 


Ce extensii folosesc fişierele sursă şi cele compilate în Java? 
Descrieți cele trei tipuri de comentarii în Java. 


Care sunt cele opt tipuri de date primitive în Java? 


. Care este diferența dintre operatorii * şi *= ? 


Explicaţi diferenţa dintre operatorii unari prefixaţi şi cei postfixaţi. 
Descrieţi cele trei tipuri de instrucţiuni de ciclare în Java. 


Descrieţi toate modurile de utilizare ale instrucţiunii break. Ce înseamnă 
o instrucţiune break etichetată? 


„ Ce face instrucţiunea continue? 


„ Ce înseamnă supraîncărcarea de metode? 


Ce înseamnă transmiterea de parametri prin valoare? 


Teorie 


l. 


Fie b cu valoarea 5 şi c cu valoarea 8. Care sunt valorile lui a, b şi c 
după execuția fiecărei linii de cod de mai jos? 


1a = b++ + c++; 
2a = b++ + ++C ; 
3a = ++b + c++ ; 
4a = ++b + ++c ; 


2. Care este rezultatul expresiei true && false |] true? 


3. Dați un exemplu pentru care ciclul for de mai jos nu este echivalent cu 


ciclul while de mai jos: 
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ı for (init; test; actualizare) 


z 

3 instructiuni; 
4) 

ı init; 

2 while (test) 

ail 

4 instructiuni; 
5 actualizare; 
6) 

Indicaţie 


In cazul în care ciclul for conţine o instucţiune continue, înainte de 
a trece la următoarea iteraţie se va executa actualizare. 


4. Pentru programul de mai jos, care sunt valorile posibile la afişare? 


public class WhatlsX 
{ 


1 

2 

3 public static void f(int x) 

4 { 

5 /*x corpul functiei este necunoscut */ 
6 } 

z 

8 public static void main(String [] args) 
9 ( 

10 int x = 0; 

11 f(x); 

12 System. out. println (x); 


In practică 


1. Scrieţi o instrucţiune while echivalentă cu ciclul for de mai jos. La ce 
ar putea fi utilizat un astfel de ciclu? 


for (; ; ) 
instructiune; 


2. Scrieţi un program care afişează numerele de la 1 la 100. Modificaţi apoi 
programul pentru a întrerupe ciclul de afişare după numărul 36 folosind 
instrucţiunea break . Încercaţi apoi să folosiţi return în loc de break. 
Care este diferenţa? 
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„ Scrieţi un program care generează tabelele pentru înmulţirea şi adunarea 
numerelor cu o singură cifră. 


. Scrieţi un program care să genereze 25 de valori aleatoare de tip int. 
Pentru fiecare valoare generată folosiţi o instrucţiune if-else pentru 
a determina dacă este mai mică, egală sau mai mare decât o altă valoare 
generată aleator. 


. Scrieţi un program care afişează toate numerele prime cu valori cuprinse 
între O şi Integer. MAX_INT. Folosiţi două cicluri for (unul pentru fiecare 
număr şi unul pentru testarea divizibilităţii) şi operatorul %. 


„ Scrieţi două metode statice. Prima să returneze maximul a trei numere 
întregi, iar a doua maximul a patru numere întregi. 


„ Scrieţi o metodă statică care primeşte ca parametru un an şi returnează 
true dacă anul este bisect şi false în caz contrar. 
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Noi nu reținem zile; reținem doar 
momente. 


Autor anonim 


În capitolul 2 am prezentat tipurile primitive din Java. Toate tipurile care 
nu fac parte dintre cele opt tipuri primitive, inclusiv tipuri importante cum ar fi 
stringuri, şiruri şi fişiere, sunt tipuri referinţă. 


In acest capitol vom învăţa: 


e Ce este un tip referinţă şi ce este o variabilă referinţă; 
e Prin ce diferă un tip referinţă de un tip primitiv; 


e Exemple de tipuri referinţă, incluzând stringuri şi şiruri. 


3.1 Ceesteo referinţă? 


În capitolul 2 am examinat cele opt tipuri primitive împreună cu câteva o- 
peraţii care pot fi realizate pe variabile având aceste tipuri. Toate celelalte tipuri 
de date din Java sunt referinţe. Ce este deci o referinţă? 


O variabilă referinţă în Java (numită adeseori simplu referință) 
este o variabilă care reţine adresa de memorie la care se află un 
anumit obiect. 
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Figura 3.1: Ilustrarea unei referințe: Obiectul de tip Complex stocat la adresa 
de memorie 1215 este referit atât de către nr2 cât şi de către nr3. Obiectul de tip 
Complex stocat la adresa 1420 este referit de către nrl. Locaţiile de memorie 
unde sunt reţinute variabilele au fost alese arbitrar. 


1215 
1420 (2, 3) 
2700 la adresa 1215 
3220 nrz = 1215 
(5,1) 
4472? Nr = 1215 
la adresa 1420 


Ca un exemplu, în Figura 3.1 există două obiecte de tipul Complex!. Pre- 
supunem că aceste obiecte au fost stocate la adresele de memorie 1215 şi res- 
pectiv 1420. Pentru aceste două obiecte am definit trei referințe, nr1, nr2 şi 
nr3. Atât nr2 cât şi nr3 referă (indică) obiectul stocat la adresa 1215; nr1 
referă obiectul stocat la adresa 1420. Aceasta înseamnă că atât nr2 cât şi nr3 
au valoarea 1215, iar nrl va avea valoarea 1420. Reţineţi că locaţiile efec- 
tive, cum ar fi 1215 şi 1420, sunt atribuite de compilator la discreţia sa (unde 
găseşte memorie liberă). În consecinţă, aceste valori nu sunt utile efectiv ca 
valori numerice. Totuşi, faptul că nr2 şi nr3 au aceeaşi valoare este folositor: 
înseamnă că ele referă acelaşi obiect. 

O referinţă stochează întotdeauna adresa la care un anumit obiect se află, cu 
excepţia situaţiei când nu referă nici un obiect. În acest caz va stoca referința 
nulă, notată în Java cu null. Limbajul Java nu permite referinţe către tipurile 
primitive (cum ar fi int sau float). 

Există două categorii distincte de operaţii care se pot aplica variabilelor re- 
ferinţă: 


l Care conţin partea reală şi cea imaginară a unui număr complex. 
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1. Prima categorie permite examinarea şi manipularea valorii referinţă. De 
exemplu, dacă modificăm valoarea stocată în nr 1 (care este 1420), putem 
să facem ca nr 1 să refere un alt obiect. Putem de asemenea compara nr 1 
şi nr3 pentru a vedea dacă referă acelaşi obiect; 


2. A doua categorie de operaţii se aplică obiectului care este referit. Am 
putea de exemplu examina sau modifica starea unuia dintre obiectele de 
tipul Complex (am putea examina partea reală şi cea imaginară a unui 
obiect de tipul Complex). Accesul la oricare obiect în Java se face ex- 
clusiv prin intermediul unei referinţe către acel obiect. 


Înainte de a descrie ce se poate face cu ajutorul referinţelor, să descriem ceea 
ce nu se poate face. Să considerăm expresia nrl * nr2. Deoarece valorile 
reţinute de nrl şi nr2 sunt respectiv 1420 şi 1215, produsul lor ar fi 1725300. 
Totuşi acest calcul este complet lipsit de sens şi rezultatul său nu are nici o 
valoarea practică. Variabilele referinţă rețin adrese şi nu poate fi asociată nici o 
semnificaţie logică înmulţirii adreselor. 

Analog, nrl++ nu are nici un sens în Java; ar sugera ca nrl - care are 
valoarea 1420 - să fie crescut la 1421, dar în acest caz nu ar mai referi un obiect 
valid. Multe alte limbaje de programare, cum ar fi C, definesc noţiunea de 
pointer care are un comportament similar cu cel al unei variabile referinţă. To- 
tuşi, pointerii în C sunt mult mai periculoşi, deoarece este permisă aritmetica pe 
adresele stocate. În plus, deoarece C permite pointeri şi către tipurile primitive 
trebuie avut grijă pentru a distinge între aritmetica pe adrese şi aritmetica pe 
variabilele care sunt referite. Acest lucru se face prin dereferenţierea explicită a 
pointerului. În practică, pointerii limbajului C tind să provoace numeroase erori 
greu detectabile, care pot adeseori provoca dureri de cap până şi programatorilor 
experimentați! 

În Java, singurele operaţii care sunt permise asupra referinţelor (cu o sin- 
gură excepţie pentru Stringuri), sunt atribuirea prin intermediul operatorului = şi 
comparaţia prin intermediul operatorilor == şi ! =. De exemplu, prin atribuirea 
lui nr3 a valorii lui nr1, vom face ca nr3 să refere acelaşi obiect pe care 
îl referă nrl. Acum expresia nrl == nr3 este adevărată, deoarece ambele 
referinţe stochează valoarea 1420 şi referă deci acelaşi obiect. nr3 != nr2 
este de asemenea adevărată, deoarece nr3 şi nr2 referă acum obiecte distincte. 

Cealaltă categorie de operaţii se referă la obiectul care este referit. Există 
doar trei acţiuni fundamentale care pot fi realizate: 


1. Aplicarea unei conversii de tip; 


2. Accesul la un câmp al obiectului sau apelul unei metode prin operatorul 
punct (.); 
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3. Utilizarea operatorului instanceof pentru a verifica dacă obiectul reţinut 
are un anumit tip. 


Secţiunea următoare ilustrează mai detaliat operaţiile pe referinţe. 


3.2 Fundamente despre obiecte şi referinţe 


În Java un obiect este orice variabilă care nu este de tip primitiv. Obiectele 
sunt tratate diferit faţă de tipurile primitive. Variabilele de tipuri primitive sunt 
manipulate prin valoare, ceea ce înseamnă că valorile lor sunt reţinute în acele 
variabile şi sunt copiate dintr-o variabilă primitivă în altă variabilă primitivă în 
timpul instrucţiunii de atribuire. După cum am arătat în secţiunea anterioară, 
variabilele referinţă stochează referinţe către obiecte. 

Obiectul în sine este stocat undeva în memorie, iar variabila referinţă sto- 
chează adresa de memorie a obiectului. Astfel, variabila referinţă nu este decât 
un nume pentru acea zonă de memorie. În consecinţă variabilele primitive şi 
cele referinţă vor avea un comportament diferit. Prezenta secţiune examinează 
mai în detaliu aceste diferenţe şi ilustrează operaţiile care sunt permise asupra 
tipurilor referinţă. 


3.2.1 Operatorul punct (.) 


Operatorul punct (.) este folosit pentru a selecta o metodă care se aplică unui 
obiect. De exemplu, să presupunem că avem un obiect de tip Cerc care de- 
fineşte metoda arie. Dacă variabila unCerc este o referinţă către un obiect 
de tip Cerc, atunci putem calcula aria cercului referit (şi salva această arie 
într-o variabilă de tip double) astfel: 


double arieCerc = unCerc.arie (); 


Este posibil ca variabila unCerc să reţină referinţa null. În acest caz, 
aplicarea operatorului punct va genera o excepţie NullPointerException 
(prezentarea excepțiilor este realizată în capitolul 6) la execuţia programului. 
De obicei această excepţie va determina terminarea anormală a programului. 

Operatorul punct poate fi folosit şi pentru a accesa componentele indivi- 
duale ale unui obiect, dacă cel care a proiectat obiectul permite acest lucru. 
Capitolul următor descrie cum se poate face acest lucru şi tot acolo vom explica 
de ce în general este preferabil să nu se permită accesul direct la componentele 
individuale ale unui obiect. 
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3.2.2 Declararea obiectelor 


Am văzut deja care este sintaxa pentru declararea variabilelor primitive. 
Pentru obiecte există o diferenţă importantă. Atunci când declarăm o referinţă, 
nu facem decât să furnizăm un nume care poate fi utilizat pentru a referi un 
obiect stocat în prealabil în memorie. Totuşi, declaraţia în sine nu furnizează şi 
acel obiect. Să presupunem, de exemplu, că avem un obiect de tip Cerc căruia 
dorim să îi calculăm aria folosind metoda arie. Să considerăm secvenţa de 
instrucţiuni de mai jos: 

1 Cerc unCerc; //unCerc poate referi un obiect de tip Cerc 
2 double arieCerc = unCerc.arie (); //calcul arie pentru cerc 


Totul pare în regulă cu aceste instrucţiuni, până când ne aducem aminte că 
unCerc este numele unui obiect oarecare de tip Cerc, dar nu am creat nici 
un cerc efectiv. În consecinţă, după ce se declară variabila unCerc, aceasta va 
conţine valoarea nul 1, ceea ce înseamnă că unCerc încă nu referă un obiect 
Cerc valid. Rezultă deci că a doua linie din secvenţa de cod de mai sus este 
incorectă, deoarece încercăm să calculăm aria unui cerc care încă nu există (este 
ca şi când am încerca să ne suim la volanul unei maşini pe care încă nu o avem). 
În exemplul de faţă chiar compilatorul va detecta eroarea, afirmând că unCerc 
"nu este iniţializat”. În alte situaţii mai complexe compilatorul nu va putea 
detecta eroarea şi se va genera o eroare NullPointerException doar la 
execuţia programului. 

Singura posibilitate (normală) de a aloca memorie unui obiect Java este fo- 
losirea cuvântului cheie new. new este folosit pentru a construi un nou obiect. 
Astfel, secvenţa de cod de mai sus corectată este: 


1 Cerc unCerc; //unCerc poate referi un obiect de tip Cerc 
2unCerc = new Cerc(); //acum unCerc refera un obiect alocat 
3 double arieCerc = unCerc.arie (); //calcul arie pentru cerc 


Remarcaţi parantezele care se pun după numele obiectului. 
Adeseori programatorii combină declararea şi iniţializarea obiectului ca în 
exemplul de mai jos: 


1 Cerc unCerc = new Cerc(); //acum unCerc refera un obiect alocat 
2 double arieCerc = unCerc.arie (); //calcul arie pentru cerc 


Multe obiecte pot fi de asemenea construite cu anumite valori iniţiale. De 


exemplu, obiectul de tip Cerc ar putea fi construit cu trei parametri, doi pentru 


coordonatele centrului şi unul pentru lungimea razei. 
1 //cerc cu centru (0, 0) si de raza 10 
2 Cerc unCerc = new Cerc(0, 0, 10); 


3// calcul ariei pentru cerc 
4 double arieCerc = unCerc.arie (); 
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3.2.3 Colectarea de gunoaie (garbage collection) 


Deoarece toate obiectele trebuie construite, ne-am putea aştepta ca atunci 
când nu mai este nevoie de ele să trebuiască să le distrugem. Totuşi, în Java, 
când un obiect din memorie nu mai este referit de nici o variabilă, memoria pe 
care o consumă va fi eliberată automat. Această tehnică se numeşte colectare 
de gunoaie. 


3.2.4 Semnificația operatorului = 


Să presupunem că avem două variabile de tipuri primitive, x şi y. În această 
situaţie, semnificaţia instrucţiunii de atribuire 


X = y; 


este simplă: valoarea stocată în y este transferată în variabila primitivă x. Mo- 
dificările ulterioare ale lui y nu afectează în nici un fel valoarea lui x. 

Pentru referințe, semnificația lui = este exact aceeaşi: se copiază valorile 
referințelor, adică adresele pe care acestea le indică. Dacă x şi y sunt referințe 
(de tipuri compatibile), atunci, după operația de atribuire, x va referi acelaşi 
obiect ca şi y. Ceea ce se copiază în acest caz sunt adrese. Obiectul pe care 
x Îl referea înainte nu mai este referit de x. Dacă x a fost singura referință 
către acel obiect, atunci obiectul nu mai este referit acum de nici o variabilă şi 
este disponibil pentru colectarea de gunoaie. Reţineţi faptul că obiectele nu se 
copiază prin operatorul =. 

Iată câteva exemple. Să presupunem că dorim să creăm două obiecte de tip 
Cerc pentru a calcula suma ariilor lor. Creăm mai întâi obiectul cerc1, după 
care încercăm să creăm obiectul cerc2 prin modificarea lui cerc1 după cum 
urmează (vezi şi Figura 3.2): 


1 Cerc cercl = new Cerc(0, 0, 10); //un cerc de raza 10 

2 Cerc cerc? = cercl; 

3cerc2 .setRaza (20); // modificam raza la 20 

4 double arieCercuri = cercl .arie() + cerc2.arie (); //calcul arie 


Acest cod nu va funcţiona corect, deoarece nu s-a construit decât un singur 
obiect de tip Cerc. Astfel, cea de-a doua instrucţiune nu face decât să spună că 
cerc2 este un alt nume pentru cerc1, construit anterior. Cercul construit în 
prima linie are acum două nume. A treia instrucţiune modifică raza cercului la 
20, dar de fapt se modifică raza unicului cerc creat, deci ultima linie adună aria 
aceluiaşi cerc de rază 20. 

Secvența de cod corectă este: 


1 Cerc cercl = new Cerc(0, 0, 10); //un cerc de raza 10 
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Figura 3.2: cercl şi cerc2 indică acelaşi obiect. Modificarea razei lui 
cerc2 implică şi modificarea razei lui cerc. 


cerci cerci 


a) cerc? = new Cerc{0, 0, 10) PA b) cerc = cerc! 


cerc? 


c) cerc2. setRaza(20) 


Cerc(D, 0, 20) 


cerc2 


2 Cerc cerc2 = new Cerc); 
3 cerc? .setRaza (20); // modificam raza la 20 
4 double arieCercuri = cercl .arie() + cerc2.arie (); //calcul arie 


La o primă vedere, faptul că obiectele nu pot fi copiate, pare să fie o limitare 
severă. În realitate însă nu este deloc aşa, deşi ne trebuie un pic de timp pentru a 
ne obişnui cu acest lucru. Există totuşi anumite situaţii când trebuie să copiem 
obiecte; în aceste situaţii se va folosi metoda clone (). clone () foloseşte 
new () pentru a crea un nou obiect duplicat. În această carte metoda clone () 
nu este folosită. 


3.2.5 Transmiterea de parametri 


Din cauza faptului că apelul se face prin valoare, parametrii actuali (de apel) 
se transpun în parametri formali folosind atribuirea obişnuită. Dacă parametrul 
trimis este un tip referință, atunci ştim deja că prin atribuire atât parametrul for- 
mal, cât şi parametrul de apel vor referi acelaşi obiect. Orice metodă aplicată 
parametrului formal este astfel implicit aplicată şi parametrului de apel. În alte 
limbaje de programare acest tip de apel se numeşte apelare prin referinţă. Uti- 
lizarea acestei noţiuni în Java ar fi oarecum nepotrivită, deoarece ne-ar putea 
face să credem că transmiterea referinţelor s-ar face în mod diferit de tipurile 
primitive. În realitate, transmiterea parametrilor nu s-a modificat; ceea ce s-a 
modificat sunt parametrii în sine, care nu mai sunt tipuri primitive, ci tipuri 
referinţă. Metoda f de mai jos primeşte ca parametri un obiect de tip Cerc şi 
o valoare întreagă. 
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public void f(Cerc unCerc, int val) 
{ 


1 
2 

3 unCerc.setRaza(val) ; //modifica raza obiectului apelant 

4 val += 5 ; //nu are nici un efect asupra parametrului actual 
5 


) 
Secvența de cod 


vint v = 5; 
2 Cerc cerc = new Cerc); 
3f(cerc, v); 


va avea ca efect modificarea razei obiectului cerc la 5, dar valoarea lui v 
va rămâne nemodificată. Explicaţie acestui fenomen este simplă: cerc şi 
unCerc sunt variabile referinţă distincte care indică acelaşi obiect, în timp 
ce v şi val sunt variabile de tip primitiv distincte, şi în consecință modificarea 
uneia nu are nici un efect asupra celeilalte. Pentru a fi mai clar, ne putem ima- 
gina că la apelul metodei f (), au loc atribuirile 


„unCerc = cerc; 
2v = val; 


după care se execută secvenţa de instrucţiuni a metodei. 


3.2.6 Semnificația operatorului == 


Pentru tipurile primitive operaţia == are valoarea true dacă acestea au va- 
lori identice. Pentru tipuri referinţă semnificaţia lui == este diferită, dar perfect 
consistentă cu discuţia din paragraful anterior. 

Două variabile referinţă sunt egale via == dacă ele referă acelaşi obiect (s-au 
ambele sunt nu11). Să considerăm următorul exemplu: 

1 Cerc cercl = new Cerc(0, 0, 10); //un cerc de raza 10 


2 Cerc cerc2 = new Cerc(0, O, 10); //un alt cerc tot de raza 10 
3 Cerc cerc3 = cerc2; 


În acest caz avem două obiecte. Primul este cunoscut sub numele de cerc, 
al doilea este cunoscut sub două nume: cerc2 şi cerc3. Expresia cerc? 
== cerc3 este adevărată. Totuşi, deşi cercl şi cerc? referă obiecte care 
au valori egale, expresia cercl == cerc2 este falsă. Chiar dacă cele două 
obiecte au valori egale (ambele sunt cercuri cu centrul în origine şi rază de 10), 
ele sunt entităţi distincte. Aceleaşi reguli se aplică şi pentru operatorul ! =. 

Cum facem însă pentru a vedea dacă obiectele referite sunt identice? De 
exemplu, cum putem să verificăm faptul că cercl şi cerc? referă obiecte 
Cerc care sunt identice? Obiectele pot fi comparate folosind metoda equals. 
Vom vedea în curând un exemplu de folosire a lui equals, în momentul în 
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care vom discuta despre tipul String. Fiecare obiect are o metodă equals, 
care, în mod implicit, nu face altceva decât testul == descris mai sus. Pentru 
ca equals să funcţioneze corect, programatorul trebuie să redefinească această 
metodă pentru obiectele pe care le crează (redefinirea metodelor va fi prezentată 
în capitolul următor). 


3.2.7  Supraîncărcarea operatorilor pentru obiecte 


În afara unei singure excepţii pe care o vom discuta în paragraful următor 
(concatenarea de şiruri), operatorii nu pot fi definiţi pentru a lucra cu obiecte?. 
Astfel, nu există operatorul < pentru nici un fel de obiect. Pentru acest scop, va 
trebui definită o metodă, cum ar fi less Than, care va realiza comparaţia. 


3.3 Şiruri de caractere (stringuri) 


Şirurile de caractere în Java sunt definite folosind tipul String. Limba- 
jul Java face să pară că String este un tip primitiv, deoarece pentru el sunt 
definiţi operatorii + şi += pentru concatenare (am arătat în paragraful anterior 
că operatorii nu pot fi aplicaţi obiectelor). Totuşi, acesta este singurul tip refe- 
rinţă pentru care Java a permis supraîncărcarea operatorilor (pentru comoditatea 
scrierii programelor). În rest, String se comportă ca orice alt obiect. 


3.3.1 Fundamentele utilizării stringurilor 


Există două reguli fundamentale referitoare la obiectele de tip String. 
Prima este aceea că, exceptând operatorul de concatenare, obiectele String 
se comportă ca toate celelalte obiecte. A doua regulă este aceea că stringurile 
sunt ne-modificabile. Aceasta înseamnă că, odată construit, un obiect de tip 
String nu mai poate fi modificat. 

Deoarece obiectele de tip String nu se pot modifica, putem folosi liniștiți 
operatorul = pentru ele, fără nici un risc. lată un exemplu: 


ı String vid = ""; 
2 String mesaj = "Salutare!" ; 
3 String repetat = mesaj; 


După aceste declarații, există două obiecte de tip String. Primul este un 
şir vid şi este referit de variabila vid, iar al doilea este şirul "Salutare!", 


? Aceasta este o diferență notabilă între Java şi C++, care permite supraîncărcarea operatorilor 
pentru obiecte. Inginerii de la Sun au considerat că supraîncărcarea operatorilor pentru obiecte 
aduce mai multe probleme decât beneficii şi au decis ca Java să nu permită acest lucru. 
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care este referit de variabilele mesaj şi repetat. Pentru majoritatea obiec- 
telor, faptul că obiectul este referit de două variabile ar putea genera probleme. 
Totuşi, deoarece stringurile nu pot fi modificate, partajarea lor nu pune nici un 
fel de probleme. Singura posibilitate de a modifica valoarea către care referă 
variabila repetat este aceea de a construi un nou obiect de tip String şi a-l 
atribui lui repetat. Această operaţie nu va avea nici un efect asupra valorii 
pe care o referă mesaj. 


3.3.2  Concatenarea stringurilor 


Java nu permite supraîncărcarea operatorilor pentru tipurile referinţă. To- 
tuşi, pentru comoditate, se acordă o excepţie specială pentru concatenarea obi- 
ectelor de tipul String. 

Atunci când cel puţin unul dintre operanzi este de tip String, operatorul + 
realizează concatenarea. Rezultatul este o referinţă către un obiect nou construit 
de tip String. lată câteva exemple: 


1 "Sunt" + " curajos!" //—> "Sunt curajos!" 

22 + " mere” //—> "2 mere", 2 este convertit la String 
3"mere " + 2 //—> "mere 2" 

ari sapa TH" op Te" //—> "abc" 


Şirurile de caractere formate dintr-un singur caracter NU trebuie înlocuite 
cu constante de tip caracter (constantele caracter sunt de fapt numere). 

Java dispune şi de operatorul += pentru şiruri de caractere. Efectul in- 
strucțiunii str += expr este str = str + expr. Cu alte cuvinte str 
va referi un nou String generat de str + expr. 

Iată un exemplu: 

1 String sl = "ab"; 
2 String s2 = "cd"; 


3sl += s2; //sl va deveni "abcd" 
4 System .out.printiln(sl); //va afisa "abcd” 


Este important să observăm că între atribuirea: 


1 = 1 +5 //i este un intreg 


şi atribuirea: 


str = str + "hello" //str este un String 


există o diferenţă esenţială. În primul caz, variabila i este incrementată cu 
5; locaţia de memorie a lui i nu se modifică. În al doilea caz, se crează un 
nou string având valoarea str + "hello". După atribuire, str va referi 
acest nou string. Fostul string referit va fi supus colectării de gunoaie (garbage- 
collection) dacă nu a existat o altă referinţă către el. 
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3.3.3 Compararea stringurilor 


Deoarece operatorul de adunare funcţionează pe şiruri de caractere, am fi 
tentaţi să credem că funcţionează şi operatorii relaţionali. Acest lucru nu este 
însă adevărat. 

Conform regulii privind supraîncărcarea operatorilor, operatorii relaționali 
(<, <=, >, >=) nu sunt definiţi pentru obiecte de tip String. Mai mult, ope- 
ratorii == şi != au semnificaţia clasică pentru obiecte de tip referinţă (compară 
adrese şi nu obiecte). De exemplu, pentru două obiecte de tip String, x şi 
y, expresia x == y este adevărată doar dacă x şi y referă acelaşi obiect de tip 
String. Astfel, dacă x şi y referă obiecte diferite cu conţinut identic, expresia 
x == y este falsă. Acelaşi raționament este valabil şi pentru ! =. 

Pentru a testa egalitatea a două obiecte de tip String, se foloseşte metoda 
equals. Expresia x.egquals (y) este adevărată dacă şirurile de caractere 
referite de x şi de y sunt identice. 

Ca exemplu să considerăm următoarele şiruri: 

ı String x = "ab"; 
2 String y = "ab"; 
3 String Z = y; 

În această situaţie, expresia x==y va fi falsă pentru că x şi y sunt referințe 
către două obiecte diferite (chiar dacă se întâmplă ca acestea să aibe acelaşi 
conținut, şi anume "ab"), în timp ce expresia y == z va fi adevărată pentru 
că y şi z sunt referințe către acelaşi obiect. Pentru a compara cele două şiruri 
de caractere referite de x şi y, se foloseşte metoda equals (). În concluzie, 
x.equals (y) va fi o expresie adevărată. 

Un test mai general poate fi realizat cu metoda compareTo (). Utilizând 
expresia x. compareTo (y), se compară două obiecte de tip String, x şi 
y. Valoarea returnată este un număr negativ, zero sau un număr pozitiv dacă x 
este mai mic, egal, respectiv mai mare decât y din punct de vedere al ordinii 
lexicografice. 

Compararea stringurilor poate fi realizată şi cu ajutorul unei alte metode, 
numită compareTolgnoreCase (). Această metodă are acelaşi comporta- 
ment cu compareTo (), doar că metoda compareTolgnoreCase () nu 
face distincţie între literele mici şi literele mari ale alfabetului. 

De exemplu, fie: 


ı String sl = "AbcD"; 
2 String s2 = "abcd"; 


În acest caz, expresia s1 .compareTo (s2) va fi falsă, pentru că "A" este 
diferit de "a", în timp ce expresia s1 .compareTolgnoreCase (s2) va fi 
adevărată pentru că metoda compareTolgnoreCase nu face diferenţa între 
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literele mari şi cele mici. Altfel spus, din punctul de vedere al metodei com- 
pareTolgnoreCase, "A" este egal cu "a". Este evident că metoda com- 
pareTolgnoreCase nu are sens să fie folosită pe şiruri de caractere care nu 
conţin litere, ca în exemplulurmător s1 .compareTolgnoreCase ("123"). 


3.3.4 Alte metode pentru stringuri 


Lungimea unui obiect de tip String (un şir vid are lungimea 0) poate 
fi obţinută cu metoda length (). Deoarece length () este o metodă, în 
momentul apelului parantezele sunt necesare. 

Există două metode pentru a accesa caracterele din interiorul unui String. 
Metoda charAt returnează caracterul aflat la poziţia specificată (primul car- 
acter este pe poziţia 0). Metoda substring returnează o referinţă către un 
String nou construit. Metoda are ca parametri poziţia de început şi poziţia 
primului caracter neinclus. 

Iată un exemplu de folosire a acestor metode: 


1 String mesaj = "Hello"; 

2 int lungimeMesaj = mesaj.length (); // lungimea este 5 
3 char ch = mesaj.charAt (1); //ch este ‘e’ 

4 String subSir = mesaj.substring (2, 4); // sub este "Il" 


Limbajul Java oferă o paletă impresionantă de metode pentru manipularea 
şirurilor de caractere. Pe lângă cele prezentate anterior, metode des utilizate 
sunt de asemenea: 


e concat() 


Descriere: metoda concat adaugă la sfârşitul unui şir de caractere un alt 
şir de caractere. Deoarece un obiect de tip String nu este modificabil 
(mutabil), prin concatenare se va crea un nou obiect, ce va fi referit de 
variabila referinţă s 1. Fostul obiect referit de s1 va fi supus colectării de 
gunoaie, în situaţia în care nici o altă variabilă nu îl referă. 


Antet: String concat (String str) 


Exemplu: 


1 String sl = "a"; 
2sl.concat("b"); //s7 devine "ab" 


e endsWith() 


Descriere: verifică dacă şirul de caractere are ca sufix un alt şir de carac- 
tere. 
TS 


3.3. ŞIRURI DE CARACTERE (STRINGURI) 


Antet: boolean endsWith(String sufix) 


Exemplu: 


1 String sl = "abcde"; 


2 
3 System. out. printin(sl.endsWith("de”)); 


4 /* 


5 * va afisa true, pentru ca sirul de caractere "abcde" se 


6 x termina cu sirul de caractere "de" 
7 */ 


e cqualsIgnoreCase() 


Descriere: verifică dacă două şiruri sunt egale, fără a face diferența între 
literele mari şi cele mici ale alfabetului . 


Antet: boolean equalsIgnoreCase(String altString) 


Exemplu: 


ı String sl = "ABc"; 


2 
3 System . out. println (sl.equalsIgnoreCase("abc")); 


4 /* 
5 * va afisa true, pentru ca nu se face diferenta intre 


6 x literele mici si cele mari ale alfabetului 
7 */ 


e getBytes() 


Descriere: converteşte stringul într-un şir de bytes(octeţi), astfel încât 
fiecărui caracter din şir îi va corespunde un întreg de tip byte, reprezen- 
tând primul byte din codul Unicode al caracterului respectiv”. 


Antet: byte[] getBytes() 


Exemplu: 


ı byte[] bl = "abcd'".getBytes(); 


2 /* 
3 * sirul bl va contine codurile Unicode ale caracterelor 


4 x ce formeaza sirul "abcd", adica 97, 98, 99, 100 
5 */ 


3În realitate, procesul este ceva mai complex: metoda getBytes () va transforma codul Uni- 
code al fiecărui caracter din şir (având 2 octeți) în codul pe 1 octet specific platformei pe care rulează 


maşina virtuală. 
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e indexo0f () 
Descriere: returnează poziţia la care se află prima apariţie a unui sub- 
şir într-un şir. Dacă subşirul nu se regăseşte în şirul respectiv, metoda 
returnează valoarea -l. 


Antet: int indexOf (String str) 


Exemplu: 

1 String sl = "Limbajul Java este orientat pe obiecte"; 
2 String s2 = "Java"; 

3 String s3 = "C++"; 


4 
s System. out. println (sl .indexOf(s2)); 
6// va afisa 9 (indicele din sl la care incepe subsirul s2) 


7 
s System. out. println (sl .indexOf(s3)); 
9// va afisa —]l (sirul sl nu contine subsirul s3) 


e lastindexOf() 


Descriere: returnează poziţia la care se află ultima apariţie a unui subşir 
într-un şir. Dacă subşirul nu se află în şirul respectiv, metoda returnează 


valoarea -1. 


Antet: int lastIndex0f (String str) 


Exemplu: 
1 String sl = "El invata Java pentru ca Java e OOP"; 
2 String s2 = "Java"; 


3 
4 System . out. println (sl. lastlndexOf(s2)); 


5 /* 
6 x va afisa 25 (indicele la care incepe ultima aparitie 


7 xa subsirului s2 in sirul sl) 
8 */ 


e replace) 


Descriere: înlocuieşte apariţiile unui caracter într-un şir cu un alt caracter 
şi returnează noul şir astfel format. Dacă respectivul caracter nu apare în 
şir, atunci noul şir va fi la fel cu cel iniţial. 


Antet: String replace(char carvechi, char carNou) 


Exemplu: 
1 String sl = "Java"; 
2 String s2 = sl.replace('a', 'i)); 


3// s2 va avea valoarea "Jivi”" 
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e startswWith() 


Descriere: verifică dacă un şir de caractere are ca prefix un alt şir de 


caractere. 


Antet: boolean startsWith(String prefix) 


Exemplu: 

1 String sl = "abcd"; 

2 System .out.printin(sl.startsWith("'abc”)); 
3 /* 


4 x va afisa true pentru ca stringul sl incepe 
5 * cu sirul de caractere "abc" 
6 */ 


e toLowerCase() 


Descriere: convertește toate literele mari din string în litere mici. 
Antet: String toLowerCase () 


Exemplu: 


ı String sl = "ABCdE"; 
2 String s2 = sl.toLowerCase (); 
3//s2 va fi egal cu "abcde" 


e toUpperCase () 


Descriere: este opusa metodei toLowerCase. Converteşte toate literele 
mici în litere mari. 


Antet: String toUpperCase () 


Exemplu: 


ı String sl "abCdE"; 
2 String s2 = sl.toUpperCase(); 
3//s2 va fi egal cu "ABDCE" 


e trim() 


Descriere: elimină spaţiile de la începutul şi sfârşitul unui şir de caractere. 


Antet: String trim() 


Exemplu: 
ı String sl = " Java "e 
2sl = sl.trim(); 


3//sl va fi egal cu "Java" 
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3.3.5 Conversia de la string la tipurile primitive şi invers 


Metoda toString () poate fi utilizată pentru a converti orice tip primi- 
tiv la String. De exemplu, toString(45) returnează o referinţă către 
şirul nou construit “45”. Majoritatea obiectelor furnizează o implementare 
a metodei toString(). De fapt, atunci când operatorul + are un operand 
de tip String, operandul care nu este de tip String este automat convertit 
la String folosind metoda toString (). Pentru tipurile de date numerice, 
există o variantă a metodei toString () care permite precizarea unei anumite 
baze. Astfel, instrucţiunea: 


System .out. printin (Integer.toString (55, 2)); 


are ca efect tipărirea reprezentării în baza 2 a numărului 55. 

Pentru a converti un String la un int există posibilitatea de a folosi 
metoda Integer .parseInt (). Această metodă generează o excepţie dacă 
String-ul convertit nu conţine o valoare întreagă. Pentru a obţine un double 
dintr-un String se poate utiliza metoda parseDouble (). lată două exem- 
ple: 


"int x = Integer.parselnt("'75"); 
2 double y = Double.parseDouble("'3.14"); 


3.4  Siruri 


Şirurile* sunt structura fundamentală prin care se pot reţine mai multe ele- 
mente de acelaşi tip. În Java, şirurile nu sunt tipuri primitive; ele se comportă 
foarte asemănător cu un obiect. Din acest motiv, multe dintre regulile care sunt 
valabile pentru obiecte se aplică şi la şiruri. 

Fiecare element dintr-un şir poate fi accesat prin mecanismul de indiciere 
oferit de operatorul [ ]. Spre deosebire de limbajele C sau C++, Java verifică 
validitatea indicilor”. 

În Java, ca şi în C, şirurile sunt întotdeauna indiciate de la 0. Astfel, un şir 
a cu 3 elemente este format dina [0], a[1], a[2]. Numărul de elemente 
care pot fi stocate în şirul a este permanent reţinut în variabila a.length. 
Observaţi că aici (spre deosebire de String-uri) nu se pun paranteze. O par- 
curgere tipică a unui şir este: 


4Desemnate în alte lucrări şi sub numele de tablouri, vectori, blocuri. 

5 Acesta este un lucru foarte important care vine în ajutorul programatorilor, mai ales a celor 
începători. Indicii a căror valoare depăşeşte numărul de elemente alocat, sunt adeseori cauza multor 
erori obscure în C şi C++. În Java, accesarea unui şir cu un indice în afara limitei este imediat 
semnalată prin excepţia Array IndexO0utOfBoundsException. 
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for (int i = 0; i < a.length; i++) 


3.4.1 Declaraţie, atribuire şi metode 


Un şir de elemente întregi se declară astfel: 
int[] sirl; 


Deoarece un şir este un obiect, declaraţia de mai sus nu alocă memorie 
pentru şir. Variabila sir 1 este doarun nume (referinţă) pentru un şir de numere 
întregi, şi în acest moment valoarea ei este nul 1. Pentru a aloca 100 de numere 
întregi, vom folosi instrucţiunea: 


sirl = new int[1l00]; 


Acum sirl este o referinţă către un şir de 100 de numere întregi. 


ege .v,e 


declaraţia şi alocarea de memorie într-o singură instrucţiune: 
int[] sirl = new int[100]; 


Se pot folosi şi liste de iniţializare, ca în C sau C++. În exemplul următor 
se alocă un şir cu patru elemente, care va fi referit de către variabila sir2: 


int[] sir2 = (3, 4,6, 19}; 


Parantezele pătrate de la declarare pot fi puse fie înainte, fie după numele 
şirului. Plasarea parantezelor înainte de nume face mai vizibil faptul că este 
vorba de un şir, de aceea vom folosi această notație. 

Declararea unui şir de obiecte (deci nu tipuri primitive) foloseşte aceeaşi 
sintaxă. Trebuie să reţineţi însă că după alocarea șirului, fiecare element din şir 
va avea valoarea nul 1. Pentru fiecare element din şir trebuie alocată memorie 
separat. De exemplu, un şir cu 5 cercuri se construieşte astfel: 


1 //declaram un sir de cercuri 

2 Cerc [] sirDeCercuri; 

3 

4//alocam memorie pentru 5 referinte la Cerc 

5 sirDeCercuri = new Cerc[5]; 

6 

"for (int i = 0; i < sirDeCercuri .length; ++i) 
a | 

9 sirDeCercuri [i] = new Cerc); 

10 // se aloca un obiect Cerc referintei nr. i 


n) 


Programul din Listing 3.1 ilustrează modul de folosire al şirurilor în Java. 
În jocul de loterie se selectează săptămânal şase numere de la 1 la 49. Programul 
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alege aleator numere pentru 1000 de jocuri şi afişează apoi de câte ori a apărut 
fiecare număr în cele 1000 de jocuri. Linia 14 declară un şir de numere întregi 
care reţine de câte ori a fost extras fiecare număr. Deoarece indicierea şirurilor 
începe de la 0, adunarea cu 1 este esenţială. Fără această adunare am fi avut 
un şir cu elemente de la O la 48, şi orice acces la elementul cu indicele 49 ar fi 
generat o excepţie ArrayIndex0utOfBoundsException (este adevărat 
că procedând în acest mod, elementul de pe poziţia 0 a rămas neutilizat). Ciclul 
din liniile 15-18 iniţializează valorile şirului cu 0. Restul programului este rela- 
tiv simplu. Se foloseşte din nou metoda Math.random () care generează un 
număr în intervalul [0, 1). Rezultatele sunt afişate în liniile 28-31. 


Listing 3.1: Program demonstrativ pentru şiruri 


1 //clasa demonstrativa pentru siruri 

2 public class Loterie 

3 { 

4 //genereaza numere de loterie intre 1 si 49 
5s //afiseaza numarul de aparitii al fiecarui numar 
6 //declaratii constante: 

7 public static final int NUMERE = 49; 

s public static final int NUMERE_PEJOC = 6; 

9 public static final int JOCURI = 1000; 

10 //main 

u public static final void main(String[] args) 


2 ë f 


13 // genereaza numerele 
14 int [] numere = new int[NUMERE + 1]; 
15 for (int i = 0; i < numere.length; ++i) 
16 { 
17 numere[i] = 0; 
18 } 
19 
20 for (int i = 0; i < JOCURI; ++i) 
21 

{ 
22 for (int j = 0 ; j < NUMERE PE JOC; ++j) 
23 

{ 

24 numere [(int ) (Math.random () * 49) + 1]++; 
25 } 
26 } 
27 // afisare rezultate 
28 for (int k = 1; k <= NUMERE; ++k) 
29 í 
30 System . out. println(k + ": " + numere[k]); 
31 } 
32) 
33 ] 
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Dat fiind faptul că şirul este un tip referinţă, operatorul = nu copiază şiruri. 
De aceea dacă x şi y sunt şiruri, efectul secvenţei de instrucțiuni: 
ıint[] x = new int[100]; 
2int[] y = new int[lO00]; 
e SE a E, 
4X = y; 


este că x şi y referă acum al doilea şir. 

Şirurile pot fi utilizate ca parametri pentru metode. Regulile de transmitere 
se deduc logic din faptul că şirul este o referinţă. Să presupunem că avem o 
metodă f care acceptă un şir de int ca parametru. Apelul şi definirea arată 
astfel: 


1 f(sirActual); //apelul metodei 
2 void f(int[] sirFormal); //declaratia metodei 


Conform convențiilor de transmitere a parametrilor în Java pentru tipurile 
referinţă, variabilele sirActual şi sirFrormal referă acelaşi obiect (la trans- 
miterea parametrului se copiază valoarea lui sirActual, care este o simplă 
adresă). Astfel, accesul la elementul sirrormal [i] este de fapt un acces la 
elementul sirActual [i]. Aceasta înseamnă că variabilele conţinute în şir 
pot fi modificate de către metodă. O observaţie importantă este aceea că linia 
de cod din cadrul metodei f: 


sirFormal = new int [20]; // (x) 


nu are nici un efect asupra lui sirActual. Acest lucru se datorează faptului 
că în Java transmiterea parametrilor se face prin valoare, iar la revenirea din 
funcţie adresa pe care o referă sirActual rămâne nemodificată. Instrucţi- 
unea de mai sus nu face decât să schimbe şirul către care referă sirrormal 
(vezi figura următoare). 


Figura 3.3: Transmiterea parametrilor în Java 


sirActual sirActual  sirFormal  sirActual sirFormal 
a. înainte de apel b. imediat după apel c. după atribuirea (*) 
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Deoarece numele şirurilor sunt doar nişte referinţe, o funcţie poate să re- 
turneze un şir. 


3.4.2 Expansiunea dinamică a şirurilor 


Să presupunem că dorim să citim o secvenţă de stringuri şi să o reținem într- 
un şir. Una dintre proprietăţile fundamentale ale şirurilor este aceea că înainte 
de a fi utilizate, trebuie să alocăm memorie pentru un număr fix de elemente 
care vor fi stocate. Dacă nu ştim de la bun început câte elemente vor fi stocate 
în şir, va fi dificil să alegem o valoare rezonabilă pentru dimensiunea şirului. 
Această secţiune prezintă o metodă prin care putem extinde dinamic şirul dacă 
dimensiunea iniţială se dovedeşte a fi prea mică. Această tehnică poartă numele 
de expansiune dinamică a şirurilor şi permite alocarea de şiruri de dimensiune 
arbitrară pe care le putem redimensiona pe măsură ce programul rulează. 

Alocarea obişnuită de memorie pentru şiruri se realizează astfel: 


String [] a = new String [10]; 
Să presupunem că după ce am făcut această declaraţie, la un moment dat 


avem nevoie de 12 elemente şi nu de 10. In această situaţie putem folosi urmă- 
toarea manevră: 


1 String [] original = a; //salvam referinta lui a 
2a = new String [12]; //alocam din nou memorie 
3 for (int i = 0; i < 10; i++) //copiem elementele in a 


a | 
5 a[i] = originall[i]; 


5) 


Un moment de gândire este suficient pentru a ne convinge că această opera- 
ție este consumatoare de resurse, deoarece şirul original trebuie copiat înapoi în 
noul şir a. De exemplu, dacă extensia dinamică a numărului de elemente ar tre- 
bui făcută ca răspuns la citirea de date, ar fi ineficient să expansionăm ori de câte 
ori citim câteva elemente. Din acest motiv, de câte ori se realizează o extensie 
dinamică, numărul de elemente este crescut cu un coeficient multiplicativ. Am 
putea de exemplu dubla numărul de elemente la fiecare expansiune dinamică. 
Astfel, dintr-un şir cu N elemente, generăm un şir cu 2N elemente, iar costul 
expansiunii este împărţit între cele N elemente care pot fi inserate în şir fără a 
realiza extensia. 

Pentru ca lucrurile să fie concrete, Listing 3.2 prezintă un program care 
citeşte un număr nelimitat de stringuri de la tastatură şi le reţine într-un şir 
a cărui dimensiune este extinsă dinamic. Oprirea din citire se realizează în 
momentul în care ultimul string introdus este egal cu stringul “end”. Funcţia 
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resize () realizează expansiunea (sau contracția!) şirului returnând o refe- 
rinţă către un şir nou construit. Similar, metoda getStrings () returnează o 
referinţă către şirul în care sunt citite elementele. 

La începutul lui getStrings (), nrElemente este iniţializat cu O şi 
alocăm memorie pentru 5 elemente. În linia 34 citim în mod repetat câte un 
element. Dacă şirul este "umplut", lucru indicat de intrarea în testul de la linia 
36, atunci şirul este expansionat prin apelul metodei resize (). Liniile 64-74 
realizează expansiunea şirului folosind strategia prezentată anterior. La linia 
42, elementul citit este stocat în tablou, iar numărul de elemente citite este in- 
crementat. În final, în linia 51 contractăm şirul la numărul de elemente citite 
efectiv. Linia 1 conţine o noţiune nouă, directiva import, care va fi prezen- 
tată pe larg în secţiunea 4.4. De asemenea liniile 31 şi 45 conţin instrucţiunea 
try-catch, care va fi prezentată în cadrul capitolului 6. 


Listing 3.2: Program pentru citirea unui număr nelimitat de stringuri urmată de 
afişarea lor 

ı import java.io.x* ; 

2/xx Citirea unui numar nelimitat de stringuri. */ 

3 public class ReadStrings 


al 


s public static void main(String [] args) 

e d 

7 String [] array = getStrings(); 

8 printSingleDimensionalArray (array ); 

9 

10 char [][] characters = stringsToChars (array ); 


11 printMultiDimensionalArray (characters ); 


2) 


14 /** 

15 x Citeste un numar nelimitat de stringuri 

16 x pana intalneste stringul "end", 

17 x fara a trata erorile 

18 */ 

19 public static String[] getStrings() 

2 f 

21 // BufferedReader este prezentata in cap. Java I/O 
22 BufferedReader in = new BufferedReader ( 

23 new InputStreamReader (System .in )); 

24 

25 String [] elemente = new String[5]; //se aloca 5 elemente 
26 int nrElemente = 0; //numarul de elemente citite 
27 String s; //sir in care se citeste cate o linie 
28 

29 System . out. println ("Introduceti stringuri:"); 
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try 
{ 
// cat timp linia este diferita de "end" 
while (!"end".equalsIgnoreCase(s = in.readLine ())) 
{ 
if (nrElemente == elemente. length ) 
{ 


// dubleaza dimensiunea sirului "umplut" 
elemente = resize(elemente, 
elemente. length + 2); 
) 
elemente [nrElemente ++] = s; 
) 
) 


catch (Exception e) 


{ 
} 


System . out. println("Citire incheiata." ); 


//nu se trateaza exceptia 


return resize(elemente, nrElemente ); 
//trunchiaza sirul la numarul de elemente citite 


} 


/*xx* Afiseaza sirul de stringuri citit. */ 
public static void printSingleDimensionalArray (String [] array) 


{ 
System . out. println ("Elementele citite sunt:"); 
for (int i = 0; i < array .length ; i++) 
System . out. println (array [i]); 
} 


/x» Redimensioneaza sirul. */ 
public static String[] resize(String[] sir, int dimensiuneNoua) 


{ 
int elementeDeCopiat = Math.min(sir.length, 
dimensiuneNoua ); 
String [] sirNou = new String [dimensiuneNoua |]; 
for (int i = 0; i < elementeDeCopiat; ++i) 
{ 
sirNou [i] = sir[i]; 
} 
return sirNou; 
) 


/*xx* Transforma String [] in char[][]. */ 
public static char[)][] stringsToChars (String [] array) 


{ 


char [][] characters = new char [array .length ][5]; 
for (int i = 0; i < array .length ; i++) 
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81 
{ 
82 characters [i] = new char[array [i]. length ()]; 
83 array [i ]. getChars (0, characters[i].length, characters[i], 0); 
84 ) 
85 
86 return characters; 
37) 


89 /xx Afiseaza o matrice de caractere. */ 
% public static void printMultiDimensionalArray ( 


91 char [][] characters) 

2 f 

93 System . out. println ("Elemente sub forma de caractere:"); 
94 

95 for (int i = 0; i < characters .length ; i++) 

96 | 

97 for (int j = 0; j < characters[i].length; j++) 

98 System . out. print(characters[i][j]); 

99 System . out. println (); 

100 } 


3.4.3 Şiruri cu mai multe dimensiuni 


În anumite situaţii trebuie să stocăm datele în şiruri cu mai multe dimen- 
siuni. Cel mai des folosite sunt matricele, adică şirurile cu două dimensiuni. 
Alocarea de memorie pentru şiruri cu mai multe dimensiuni se realizează pre- 
cizând numărul de elemente pentru fiecare indice, iar indicierea se face plasând 
fiecare indice între paranteze pătrate. Ca un exemplu, declaraţia: 


int[][] x = new int[2][3]; 


defineşte matricea x, în care primul indice poate fi O sau 1, iar al doilea poate 
lua valori de la O la 2. 

Listing 3.2 oferă un exemplu simplu de utilizare a unei matrici. După cum 
se poate observa la linia 10, şirul de stringuri ce a fost citit de la tastatură este 
transformat într-o matrice de caractere (câte un şir de caractere pentru fiecare 
string în parte). Metoda printMultiDimensionalArray prezintă modul 
de parcurgere a elementelor matricei obţinute. 


3.4.4 Argumente în linie de comandă 


Parametrii transmişi în linie de comandă sunt disponibili în cadrul unei apli- 
caţii, prin examinarea parametrilor funcției main (). Şirul de stringuri numit 
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args din funcţia main conţine parametrii transmişi programului Java în linia 
de comandă. De exemplu, dacă avem un program numit Suma. java pe care 
îl executăm cu comanda: 


java Suma 2 3 


atunci parametrul args [0] va fi o referinţă către stringul "2", iar parametrul 
args [1] vafio referinţă către "3". Astfel, programul următor implementează 
o comandă de adunare a numerelor trimise ca argument: 


Listing 3.3: Utilizarea argumentelor în linie de comandă 


public class Suma 
{ 


1 
2 
3 //afiseaza suma parametrilor primiti in linie de comanda 
4 public static void main(String [] args) 
5 
{ 

6 if (args.length == 0) 
7 { 
8 System . out. println ("Nu exista argumente"); 
9 return; 
10 ) 
11 
12 double suma = Q0; 
13 
14 for (int i = 0; i < args.length; ++i) 
15 

{ 
16 suma += Double .parseDouble(args[i]); 
17 } 
18 
19 System . out. println ("Suma argumentelor: " + suma); 
2 } 
2] 
Rezumat 


Capitolul de faţă a prezentat tipurile referinţă. O referinţă este o variabilă 
care stochează adresa de memorie unde se află un obiect sau referinţa specială 
null. Referințele pot indica doar obiecte, nu şi variabile de tipuri primitive. 
Orice obiect poate fi referit prin una sau mai multe variabile referinţă. 

Deoarece în Java există doar opt tipuri primitive, aproape totul se traduce în 
obiecte şi clase. Dintre obiecte, stringurile au un tratament mai special, pentru 
că se pot folosi pentru concatenare operatorii + şi +=. În rest, stringurile sunt 
la fel ca orice alt tip referinţă. Pentru a testa dacă două stringuri sunt egale ca şi 
conţinut, se foloseşte metoda equals. 
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Şirurile reprezintă o colecţie de elemente de acelaşi tip. Este important să 
reținem faptul că indicele de numerotare a elementelor din şir porneşte întot- 
deauna de la 0. 

În cadrul capitolului care urmează vom prezenta modul în care putem defini 
noi tipuri de date în Java, folosind noţiunea de clase. 


Noţiuni fundamentale 


apelare prin referinţă: în majoritatea limbajelor de programare, aceasta 
înseamnă că parametrul formal reprezintă o referinţă către parametrul actual. 
Acest efect este atins în mod natural în Java în momentul în care se utilizează 
apelul prin valoare pentru tipuri referinţă. 

argument în linie de comandă: argumente transmise la execuţia unui pro- 
gram Java şi care sunt preluate în funcţia main (). 

colectarea de gunoaie: eliberearea automată din memorie a obiectelor care 
nu mai sunt referite. 

construirea: pentru obiecte, se realizează prin intermediul cuvântului cheie 
new. 

equals: metodă prin care se poate compara dacă valorile stocate de două 
obiecte sunt egale. 

length (atribut): folosit pentru a determina dimensiunea unui şir. 

length (metodă): folosită pentru a determina lungimea unui obiect de tip 
String. 

obiect: o entitate de tip neprimitiv. 

new: folosit pentru a construi noi obiecte. 

null: referință specială prin care se specifică faptul că nu se face referire 
la nici un obiect. 

NullPointerException: tip de excepție generată de încercarea de a 
accesa un atribut sau o metodă pe o referință null. 

pointer: ca şi referinţa, pointerul conţine adresa la care se află un obiect. 
Spre deosebire de referinţe, pointerii necesită o dereferenţiere explicită pentru 
a putea manipula obiectul indicat. În Java nu există pointeri. 

referinţă: variabilă care stochează adresa la care se află un obiect, şi prin 
intermediul căreia poate fi manipulat obiectul care este referit. 

şir: reţine o colecţie de obiecte de acelaşi tip 


Erori frecvente 


1. Pentru tipuri referinţă operatorul = nu copiază valorile obiectelor. El 
copiază doar adrese. 
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. Pentru tipuri referinţă (inclusiv stringuri) trebuie folosită metoda equal s 
în loc de == pentru a testa dacă obiectele referite sunt egale ca şi conţinut. 


. Alocarea cu un element mai puţin decât trebuie pentru şiruri (indexarea 
începe de la 0!). 


. Tipurile referinţă sunt implicit iniţializate cu nul 1. Nici un obiect nu este 
construit fără apelul lui new. O excepţie NullPointerException 
indică faptul că aţi uitat să alocaţi memorie pentru un obiect. 


. În Java şirurile sunt indexate la 0 la N - 1, unde N este dimensiunea 
şirului. Totuşi Java verifică valoarea indicilor, şi accesul în afara limitelor 
este detectat în timpul execuţiei. 


. Şirurile bidimensionale sunt indexate prin A [i] [j] şinuA[i, j] ca în 
Pascal. 


. Folosiţi ” ” şi nu ° * pentru a scrie un spaţiu sau alte caractere. 


Exerciţii 


Pe scurt 


1. Care sunt diferenţele majore între tipurile primitive şi tipurile referinţă? 


2. Enumeraţi 5 operaţii care se pot aplica unui tip referinţă. 


3. Enumeraţi operaţiile de bază care pot fi efectuate pe stringuri. 


Teorie 


1. Dacă x şi y au valorile 5 respectiv 7, care este rezultatul următoarei 


afişări: 


9 i 


System .out. println(x + 
System .out. printin (x + 


+ y); 
"n" o" y); 


» 


In practică 


1. Creați un şir de obiecte de tip String şi asociaţi un String fiecărui 
element din şir. Afişaţi apoi elementele şirului în cadrul unui ciclu for. 


2. Scrieţi o metodă care returnează true dacă stringul strl este prefix 
pentru stringul str2. Nu folosiţi nici o metodă generală de căutare pe 


stringuri în afară de charat. 
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3. Scrieţi un program care preia trei argumente de tip String din linia de 
comandă şi le afişează pe ecran. 
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4. Obiecte şi clase 


Cuvintele sau limbajul, aşa cum 
sunt ele scrise sau vorbite nu par 
să joace nici un rol în mecanismul 
gândirii mele. Obiectele care par 
să serverască drept elemente în 
gândirea mea sunt anumite semne 
şi imagini mai mult sau mai puţin 
clare care pot fi în mod voluntar 
reproduse sau combinate. 


Albert Einstein 


În acest capitol vom începe să discutăm despre programarea orientată pe 
obiecte (object oriented programming - OOP) în Java. O componentă fun- 
damentală a programării orientate pe obiecte este specificarea, implementarea 
şi folosirea obiectelor. În capitolul anterior am văzut deja câteva exemple de 
obiecte, cum ar fi stringurile, care fac parte din bibliotecile limbajului Java. Am 
putut observa şi faptul că fiecare obiect este caracterizat de o anumită stare care 
poate fi modificată prin aplicarea operatorului punct (.). În limbajul Java, starea 
şi funcţionalitatea unui obiect se definesc prin intermediul unei clase. Un obiect 
este de fapt o instanţă a unei clase. 

În cadrul capitolulului de faţă vom prezenta: 


e Cum se foloseşte în Java conceptul de clasă pentru a obţine încapsularea 
şi ascunderea de informaţii, concepte fundamentale ale OOP; 


e Cum se implementează o clasă Java; 


e Cum se pot grupa clasele în pachete pe baza funcţionalităţii lor comune. 
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4.1 Ce este programarea orientată pe obiecte? 


Programarea orientată pe obiecte s-a impus ca modelul dominant al anilor 
'90 şi continuă să domine şi în deceniul curent. În această secţiune vom prezenta 
modul în care Java suportă programarea orientată pe obiecte şi vom menţiona 
câteva dintre principiile ei fundamentale. 

În centrul programării orientate pe obiecte se află noţiunea de obiect. Obiec- 
tul este o variabilă complexă definit de o structură şi o stare. Fiecare obiect 
dispune de operații prin intermediul cărora i se poate manipula starea. Aşa 
cum am văzut deja, în limbajul Java se face distincţie între un obiect şi o vari- 
abilă de un tip primitiv, dar aceasta este o specificitate a limbajului Java şi nu a 
programării orientate pe obiecte în general. Pe lângă operaţiile cu un caracter 
general, asupra obiectelor se mai pot realiza şi alte operaţii: 


e Crearea de noi obiecte, însoţită eventual de iniţializarea obiectelor; 
e Copierea şi testarea egalităţii; 
e Realizarea de operaţii de intrare/ieşire cu obiecte. 


Obiectul trebuie privit ca o unitate atomică pe care utilizatorul nu ar trebui să 
o disece. În mod normal, nu ne punem problema de a jongla cu bitii din care 
este format un număr reprezentat în virgulă mobilă şi ar fi de-a dreptul ridi- 
col să încercăm să incrementăm un astfel de număr prin modificarea directă a 
reprezentării sale interne. 

Principiul atomicităţii este cunoscut sub numele de ascunderea informaţi- 
ei. Utilizatorul nu are acces direct la componentele unui obiect sau la imple- 
mentarea sa. Acestea vor putea fi accesate doar prin intermediul metodelor 
care au fost furnizate împreună cu obiectul. Putem privi fiecare obiect ca fi- 
ind ambalat într-o cutie pe care este scris "Nu deschideţi! Nu conţine compo- 
nente reparabile de către utilizator!". În viaţa de zi cu zi, majoritatea celor care 
încearcă să repare componente cu această inscripţie sfârşesc prin a face mai 
mult rău decât bine. Din acest punct de vedere, programarea imită lumea reală. 
Gruparea datelor şi a operaţiilor asupra acestor date în acelaşi întreg (agregat), 
având grijă să ascundem detaliile de implementare ale agregatului, este cunos- 
cută sub numele de încapsulare. Aşadar, datele sunt ascunse, iar accesul lor 
se realizează prin intermediul operaţiilor încapsulate împreună cu ele, numite 
metode. 

Unul dintre principalele scopuri ale programării orientate pe obiecte este re- 
utilizarea codului. La fel cum inginerii refolosesc din nou şi din nou aceleaşi 
componente în proiectarea de componente electronice, programatorii ar trebui 
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să refolosească obiectele în loc să le reimplementeze. Există două situaţii dis- 
tincte legate de reutilizarea codului (refolosirea obiectelor): 


1. Situaţia în care avem deja la dispoziţie un obiect care implementează ex- 
act comportamentul pe care îl dorim. Refolosirea obiectului nu pune în 
acest caz nici un fel de probleme; 


2. Situaţia în care dorim să folosim un obiect care deja există, dar care, deşi 
are un comportament foarte similar cu ceea ce vrem, nu corespunde ex- 
act cu necesităţile noastre. Aici este de fapt adevărata provocare: obiectul 
existent va trebui extins pentru a fi adaptat la comportamentul dorit. Ast- 
fel se economiseşte timp de dezvoltare, deoarece adeseori este mult mai 
uşor să se adapteze un obiect deja existent (a cărui funcţionalitate este 
asemănătoare cu cea a obiectului de care avem nevoie) decât să se rescrie 
totul de la zero. 


Limbajele de programare orientate pe obiecte furnizează mai multe mecanisme 
pentru a facilita reutilizarea codului. Unul dintre mecanisme este folosirea co- 
dului generic. Dacă implementarea este identică, şi diferă doar tipul de bază 
al obiectului, nu este necesar să rescriem complet codul: vom scrie în schimb 
un cod generic care funcţionează pentru orice tip. De exemplu, algoritmul de 
sortare al unui şir de obiecte nu depinde de obiectele care sunt sortate, deci se 
poate implementa un algoritm generic de sortare. 

Moștenirea este un alt mecanism care permite extinderea funcţionalităţii 
unui obiect. Cu alte cuvinte, putem crea noi tipuri de date care să extindă (sau 
să restricţioneze) proprietăţile tipului de date original. 

Un alt principiu important al programării orientate pe obiecte este polimor- 
fismul. Un tip referinţă polimorfic poate să refere obiecte de mai multe tipuri. 
Atunci când se apelează o metodă a tipului polimorfic, se va selecta automat 
metoda care corespunde tipului referit în acel moment (vom descrie în detaliu 
atât moştenirea cât şi polimorfismul în capitolul următor). 

Un obiect în Java este o instanţă a unei clase. O clasă este similară cu un tip 
record din Pascal sau cu o structură din C, doar că există două îmbunătăţiri ma- 
jore. În primul rând, membrii clasei pot fi atât funcţii cât şi date, numite în acest 
context metode, respectiv atribute. În al doilea rând, domeniul de vizibilitate 
al acestor membri poate fi restricţionat. Deoarece metodele care manipulează 
starea obiectului sunt membri ai clasei, ele sunt accesate prin intermediul o- 
peratorului punct, la fel ca şi atributele. În terminologia programării orientate 
pe obiecte, atunci când apelăm o metodă a obiectului spunem că "trimitem un 
mesaj" obiectului. 
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4.2 Un exemplu simplu 


Să ne amintim că, atunci când proiectăm o clasă, este important să ascundem 
detaliile interne faţă de utilizatorul clasei. Clasa poate să îşi definească funcţio- 
nalitatea prin intermediul metodelor. Unele dintre aceste metode vor descrie 
cum se creează şi se iniţializează o instanţă a clasei, cum se realizează testele 
de egalitate şi cum se descrie starea clasei. Celelalte metode sunt specifice 
structurii particulare pe care o are clasa. Ideea este că utilizatorul nu trebuie să 
aibă dreptul de a modifica direct starea obiectului, ci el va trebui să folosească 
metodele clasei pentru a realiza acest lucru. Această idee poate fi impusă prin 
ascunderea anumitor membri faţă de utilizator. Pentru a realiza aceasta, vom 
preciza ca aceşti membri să fie stocaţi în secţiunea private. Compilatorul va 
avea grijă ca membri din secţiunea private să fie inaccesibili utilizatorului 
acelui obiect. În general, toate atributele unui obiect ar trebui să fie declarate 
private. 

Programul din Listing 4.1 prezintă modul de definire al unei clase care mo- 
delează un cerc. Definirea clasei constă în două părţi: public şi private. 
Secţiunea public reprezintă porţiunea care este vizibilă pentru utilizatorul 
obiectului. Deoarece datele sunt ascunse faţă de utilizator, secţiunea public 
va conţine în mod normal numai metode şi constante. În exemplul nostru avem 
două metode, una pentru a scrie şi una pentru a citi raza obiectelor de tip 
Circle. Celelalte două metode calculează aria respectiv lungimea obiectu- 
lui de tip Circle. Secţiunea private conţine datele; acestea sunt invizibile 
pentru utilizatorul obiectului. Atributul radius poate fi accesat doar prin in- 
termediul metodelor publice setRadius () şi getRadius (). 


Listing 4.1: Definirea clasei Circle 


I /** 

2* Clasa simpla Java care modeleaza un Cerc. 
3 */ 

4 public class Circle 


6 //raza cercului 

7 //valoarea razei nu poate fi modificata 
sa //direct de catre utilizator 

o private double radius; 


u /x* Modifica raza cercului */ 

2 public void setRadius (double r) 
34 

14 radius = r; 


5) 


6  /x* Metoda ptr a obtine raza cercului.x*/ 


4.2. UN EXEMPLU SIMPLU 


7 public double getRadius () 
Bo f 


19 return radius; 
2) 
2 /xx Metoda ptr calculul ariei cercului.*/ 
2 public double area () 
2z f 
24 return Math.PI + radius + radius; 
25 
) 


26  /*xx*x Metoda ptr calculul lungimii. x*/ 
21 public double length () 
2 ë ě { 
29 return 2 * Math.PI + radius; 
30 
) 


Programul din Listing 4.2 prezintă modul de folosire al unui obiect de tip 
Circle. Deorece setRadius (), getRadius(),area() şi length () 
sunt membri ai clasei, ei sunt accesaţi folosind operatorul punct. Atributul 
radius ar fi putut şi el să fie accesat folosind operatorul punct, dacă nu ar 
fi fost declarat de tip private. Accesarea lui radius din linia 15 ar fi fost 
ilegală dacă nu era comentată folosind //. 

Să rezumăm terminologia învățată. O clasă conţine membri care pot fi 
atribute (câmpuri, date) sau metode (funcţii). Metodele pot acţiona asupra 
atributelor şi pot apela alte metode. Modificatorul de vizibilitate public face 
ca membrul respectiv să fie accesibil oricui prin intermediul operatorului punct. 
Modificatorul de vizibilitate private face ca membrul respectiv să fie acce- 
sibil doar metodelor clasei. Dacă nu se pune nici un modificator de vizibilitate, 
atunci accesul la membru este de tip friendly, despre care vom vorbi în paragra- 
ful 4.4.4. Mai există şi un al patrulea modificator, numit protected pe care 
îl vom prezenta în capitolul următor. 


Listing 4.2: Testarea clasei Circle 


//clasa simpla de testare a clasei Circle 
public class TestCircle 


l 

2 

3 A 

4 public static void main(String [] args) 
5 { 

6 Circle circle = new Circle (); 

7 
8 circle .setRadius (10); 

9 System . out. println ("Raza= 


10 System . out. println ("Aria= 
Ll System . out. println ("Lungimea= 


Li] 


+ circle . getRadius ()); 
+ circle .area()); 
" + circle. length ()); 


Li] 


13 // urmatoarea linie ar genera o 
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14 //eroare de compilare 
15 // circle. radius = 20; 


16 ) 
iz) 


4.3 Metode uzuale 


Metodele unei clase se pot grupa în două categorii: 
e metode clasice, uzuale, care se regăsesc în (aproape) toate clasele; 
e metode care definesc comportamente specifice unei anumite clase. 


In această secţiune vom prezenta prima categorie de metode: constructorii, 
modificatorii, accesorii, toString() şieguals(). 


4.3.1 Constructori 


Aşa cum am menţionat deja, una dintre proprietăţile fundamentale ale obi- 
ectelor este că acestea pot fi definite şi, eventual, iniţializate. În limbajul Java, 
metoda care controlează modul în care un obiect este creat şi iniţializat este 
constructorul. Deoarece Java permite supraîncărcarea metodelor, o clasă poate 
să definească mai mulţi constructori. 

Dacă la definirea clasei nu se furnizează nici un constructor, cum este cazul 
clasei Circle din Listing 4.1, compilatorul creează automat un construc- 
tor implicit care iniţializează fiecare membru cu valorile implicite. Aceasta 
înseamnă că atributele de tipuri primitive sunt iniţializate cu O (cele boolean cu 
false), iar atributele de tip referinţă sunt iniţializate cu null. Astfel, în cazul 
nostru, atributul radius va avea implicit valoarea 0. 

Pentru a furniza un constructor, vom scrie o metodă care are acelaşi nume 
cu clasa şi care nu returnează nimic. În Listing 4.3 avem doi constructori: unul 
începe la linia 7, iar celălalt la linia 15. Folosind aceşti doi constructori vom 
putea crea obiecte de tip Date în următoarele moduri: 


Date dl new Date(); 
Date d2 = new Date(15, 3, 2000); 


De remarcat faptul că odată ce aţi definit un constructor pentru o clasă, com- 
pilatorul nu mai generează constructorul implicit fără parametri. Dacă veţi avea 
nevoie de un constructor fără parametri, va trebui acum să îl scrieţi singuri. De 
exemplu, constructorul din linia 7 trebuie definit obligatoriu pentru a putea crea 
un obiect de tipul celui referit de către d1. 
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Listing 4.3: O clasă Date minimală care ilustrează constructorii şi metodele 
equals () şi toString() 


//clasa Java simpla pentru stocarea unei 
//date calendaristice 


L 

2 

3 //nu se face validarea datelor 

4 public class Date 

s { 

6 // constructor fara parametri 

7 public Date () 

8 { 

9 day = l; 

10 month = 1; 

LL year = 2000; 

12 } 

13 

14 // constructor cu trei parametri 
15 public Date(int theDay, int theMonth, int theYear) 
16 { 

17 day = theDay; 

18 month = theMonth; 

19 year = theYear; 

20 } 

2l 

22 // test de egalitate 

23 // intoarce true daca Obiectul x 
24 // este egal cu obiectul curent 
25 public boolean equals(Object x) 
26 { 

27 if (!(x instanceof Date)) 

28 return false; 

29 Date date = (Date) x; 

30 return date.day == day && date.month == month 
31 && date.year == year; 

32 } 

33 

34 // conversie la String 

35 public String toString () 

36 | 

37 return day + "/" + month + "/" + year ; 
38 } 

39 

40 // atribute 

4l private int day; 

42 private int month; 

43 private int year; 

a) 
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4.3.2  Modificatori şi accesori 


Atributele sunt declarate de obicei ca fiind private. Aceasta înseamnă că 
ele nu vor putea fi direct accesate de către rutinele care nu aparţin clasei. Există 
totuşi multe situaţii în care dorim să examinăm sau chiar să modificăm valoarea 
unui atribut. 

O posibilitate este aceea de a declara atributele ca fiind public. Aceasta 
nu este o soluţie elegantă, deoarece încalcă principiul ascunderii informaţiei. 
Putem însă scrie metode care să examineze sau să modifice valoarea fiecărui 
câmp. O metodă care citeşte, dar nu modifică starea unui obiect este numită 
accesor. O metodă care modifică starea unui obiect este numită modificator 
(engl. mutator). 

Cazuri particulare de accesori şi modificatori sunt cele care acţionează asu- 
pra unui singur câmp. Accesorii de acest tip au un nume care începe de obicei 
cu get, cum ar fi getRadius (), iar modificatorii au un nume care începe 
de regulă cu set, cum ar fi setRadius (). Aceste metode sunt atât de des 
folosite în Java, încât au şi denumiri consacrate în limbajul uzual al programa- 
torilor Java: getteri, respectiv setteri (a nu se confunda cu rasa de patrupede 
care poartă acelaşi nume). 

Avantajul folosirii unui modificator (sau a unui setter) este că acesta poate 
verifica dacă starea obiectului este corectă. Astfel, un setter care modifică 
atributul day al unui obiect de tip Date poate verifica corectitudinea datei 
care rezultă. 


4.3.3  Afişareşitostring() 


În general, afişarea stării unui obiect se face utilizând metoda print () din 
clasa System. out. Pentru a putea face acest lucru trebuie ca obiectul care se 
doreşte a fi afişat să conţină o metodă cu numele de toSstring(). Această 
metodă întoarce un String (reprezentând starea obiectului) care poate fi afişat. 
Ca un exemplu, în Listing 4.3 am prezentat o implementare rudimentară a unei 
metode toString() pentru clasa Date în liniile 35-38. Definirea acestei 
metode permite să afişăm un obiect d1 de tip Date folosind instrucţiunea 
System.out.print (d1). Practic, compilatorul Java nu face altceva decât 
să invoce automat toString() pentru fiecare obiect care se afişează. Ast- 
fel System.out .print (d1) este tradusă de către compilator în instrucţi- 
unea System.out.print(dl.tostring()). Această simplă facilitate 
lasă impresia programatorilor neavizaţi că metoda print () “ştie” să afişeze 
obiecte Java. În realitate, metoda print () nu ştie decât să afişeze stringuri. 
Compilatorul Java este însă suficient de inteligent pentru a transforma obiectele 
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în stringuri, prin apelul metodei toString () (de altfel, tot compilatorul este 
cel care converteşte la afişare şi tipurile primitive la String, atunci când este 
cazul). 


4.3.4 Metoda equals () 


Metoda equals este folosită pentru a testa dacă două referințe indică obi- 
ecte care au aceeaşi valoare (stare). Antetul acestei metode este întotdeauna 


public boolean equals (Object rhs) 


Aţi remarcat probabil nedumeriți faptul că parametrul trimis metodei este 
de tip Object şi nu de tip Date, cum ar fi fost de aşteptat. Rațiunea acestui 
lucru o să o prezentăm în capitolul următor. În general, metoda equals pentru 
o clasă X este implementată în aşa fel încât să returneze true doar dacă rhs 
(abreviere pentru “right hand side”, adică operandul din partea dreaptă a expre- 
siei) este o instanță a lui X şi, în plus, după conversia la X toate atributele lui 
rhs sunt egale cu atributele obiectulului (atributele de tip primitiv trebuie să fie 
egale via ==, iar atributele de tip referință trebuie să fie egale via equals ()). 

Un exemplu de implementare a lui equal s este dat în Listing 4.3 pentru 
clasa Date în liniile 25-32. 


4.3.5 Metode statice 


Există anumite cuvinte cheie ale limbajului Java care specifică proprietăţi 
speciale pentru unele atribute sau metode. Un astfel de cuvânt cheie este sta- 
tic. Atributele şi metodele declarate static într-o clasă, sunt aceleaşi pentru 
toate obiectele, adică pentru toate variabilele de tipul acelei clase. Fiind identice 
pentru toate obiectele unei clase, metodele statice pot fi accesate fără să fie 
nevoie de o instanţiere a clasei respective (adică de o variabilă de clasa respec- 
tivă). Metodele statice pot utiliza variabile statice declarate în interiorul clasei. 

Cel mai cunoscut exemplu de metodă statică este main (). Alte exemple de 
metode statice pot fi găsite în clasele String, Integer şi Math. Exemple 
de astfel de metode sunt String.valueOf (), Integer.parselInt(), 
Math.sin() şi Math.max (). Accesul la metodele statice respectă aceleaşi 
reguli de vizibilitate ca şi metodele normale. 


4.3.6 Atribute statice 


Atributele statice sunt folosite în situația în care avem variabile care trebuie 
partajate de către toate instanțele unei clase. De obicei atributele statice sunt 
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constante simbolice, dar acest lucru nu este obligatoriu. Atunci când un atribut 
al unei clase este declarat de tip static, doar o singură instanţă a acelei variabile 
va fi creată. Ea nu face parte din nici o instanţă a clasei. Ea se comportă ca 
un fel de variabilă globală unică, vizibilă în cadrul clasei. Cu alte cuvinte, dacă 
avem declaraţia 


ı public class Exemplu 

2 4 

3 private int x; 

4 private static int y; 
5 


) 


fiecare obiect de tip Exemplu va avea propriul atribut x, dar va fi doar un 
singur y partajat de toate instanţele clasei Exemplu. 

O folosire frecventă pentru câmpurile statice o reprezintă constantele. De 
exemplu, clasa Integer defineşte atributul MAX_ VALUE astfel 


public final static int MAX VALUE = 2147483647; 


Analog se defineşte şi constanta PI din clasa Math pe care am folosit- 
o în clasa Circle. Modificatorul final indică faptul că identificatorul care 
urmează este o constantă. Dacă această constantă nu ar fi fostun atribut static, 
atunci fiecare instanţă a clasei Integer ar fi avut un atribut cu numele de 
MAX_VALUE, irosind astfel inutil spaţiu în memorie. 

Astfel, vom avea o singură variabilă cu numele de MAX_ VALUE. Constanta 
poate fi accesată de oricare dintre metodele clasei Integer prin identificatorul 
MAX_VALUE. Ea va putea fi folosită şi de către un obiect de tip Integer numit 
x prin sintaxa x .MAX_VALUE, ca orice alt câmp. Acest lucru este permis doar 
pentru că MAX_VALUE este public. În sfârşit, MAX_VALUE poate fi folosit şi 
prin intermediul numelui clasei ca Integer .MAX_VALUE (tot pentru că este 
public). Această ultimă folosire nu ar fi fost permisă pentru un câmp care nu 
este static. 

Chiar şi fără modificatorul final, atributele statice sunt foarte folositoare. 
Să presupunem că vrem să reținem numărul de obiecte de tip Circle care 
au fost construite. Pentru aceasta avem nevoie de o variabilă statică. În clasa 
Circle vom face declaraţia: 


private static int numarlnstante = 0; 


Vom putea apoi incrementa numărul de instanţe în constructor. Dacă acest 
câmp nu ar fi fost de tip static am avea un comportament incorect, deoarece 
fiecare obiect de tip Circle ar fi avut propriul atribut numarInstante care 
ar fi fost incrementat de la O la 1. 

Remarcaţi faptul că, deoarece un atribut de tip static nu necesită un obiect 
care să îl controleze, fiind partajat de către toate instanţele clasei, el poate fi 
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folosit de către o metodă statică (dacă regulile de vizibilitate permit acest lucru). 
Atributele nestatice ale unei clase vor putea fi folosite de către o metodă statică 
doar dacă se furnizează şi un obiect care să le controleze. 


4.3.7 Metoda main () 


Atunci când este invocat, interpretorul java caută metoda main () din 
clasa care i se dă ca parametru. Astfel, în situaţia în care aplicaţia noastră este 
formată din mai multe clase, putem scrie câte o metodă main () pentru fiecare 
clasă. Acest lucru ne permite să testăm funcţionalitatea de bază a claselor indi- 
viduale. Trebuie să avem totuşi în vedere faptul că plasarea funcţiei main () 
în cadrul clasei ne conferă mai multă vizibilitate decât ne-ar fi permis prin uti- 
lizarea clasei din alt loc. Astfel, apeluri ale metodelor private pot fi făcute 
în test, dar ele vor eşua când vor fi utilizate în afara clasei. 


4.4 Pachete 


Pachetele sunt folosite pentru a organiza clasele similare. Fiecare pachet 
constă dintr-o mulţime de clase. Clasele care sunt în acelaşi pachet au restricții 
de vizibilitate mai slabe între ele decât clasele din pachete diferite. 

Java oferă o serie de pachete predefinite, printre care java. io, java.awt, 
java. lang, java.util, java.applet etc. Pachetul java. lang in- 
clude, printre altele, clasele Integer, Math, String şi System. Clase 
mai cunoscute din java.util sunt Date, Random, StringTokenizer. 
Pachetul java. io cuprinde diverse clase pentru stream-uri, pe care le vom 
prezenta în capitolul 7. De asemenea, pentru o prezentare mai amănunţită a 
pachetelor predefinite, vă recomandăm să consultaţi anexa C. Pe lângă infor- 
maţii detaliate despre aceste pachete şi despre modalitatea de a vă crea propriile 
dumneavoastră pachete, anexa C prezintă şi noţiunea de arhivă jar, foarte utilă 
în cadrul aplicaţiilor de dimensiuni mai mari. 

O clasă oarecare C dintr-un pachet P este desemnată prin P . C. De exemplu, 
putem declara un obiect de tip Date care să conţină data şi ora curentă astfel: 


java. util. Date today = new java.util.Date(); 


Observaţi că prin specificarea numelui pachetului din care face parte clasa, 
evităm conflictele care pot fi generate de clase cu acelaşi nume din pachete 
diferite! 


! De exemplu, cu clasa Date definită anterior în secțiunea 4.3. 
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4.4.1 Directiva import 


Utilizarea permanentă a numelui pachetului din care fac parte clasele poate 
fi uneori deosebit de anevoioasă. Pentru a evita acest lucru se foloseşte directiva 
import: 


import NumePachet .NumeClasa; 


sau 


import NumePachet .x; 


Dacă recurgem la prima formă a directivei import, vom putea folosi de- 
numirea NumeClasa ca o prescurtare pentru numele clasei cu calificare com- 
pletă. Dacă folosim cea de-a doua formă, toate clasele din pachet vor putea fi 
abreviate cu numele lor neprecedat de numele pachetului. 

De exemplu, realizând directivele import de mai jos: 


import java.util.Date; 
2 import java.io.x; 


putem să folosim: 


ı Date today = new Date); 
2 FileReader file = new FileReader(name); 


Folosirea directivelor import economiseşte timpul de scriere. Având în 
vedere că cea de-a doua formă este mai generală, ea este şi cel mai des folosită. 
Există două dezavantaje ale folosirii directivei import. Primul dezavantaj este 
acela că la citirea codului va fi mai greu de stabilit pachetul din care o anumită 
clasă face parte. Al doilea este acela că folosirea celei de-a doua forme poate 
să introducă prescurtări neintenţionate pentru anumite clase, ceea ce va genera 
conflicte de denumire care vor trebui rezolvate prin folosirea de nume de clase 
calificate. 

Să presupunem că avem următoarele directive: 


ı import java.util.x;  //pachet predefinit 
2import myutil.*; // pachet definit de catre noi 


cu intenția de a importa clasa java.util .Random şi o clasă pe care am defi- 
nit-o chiar noi. Atunci, dacă noi avem propria clasă Date în pachetulmyutil, 
directiva import va genera un conflict cu java.util.Date şi, din această 
cauză, clasa va trebui să fie complet calificată ori de câte ori este utilizată. Am 
fi putut evita aceste probleme dacă am fi folosit prima formă 


import java.util .Random ; 
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Directivele import trebuie să apară înainte de orice declarare a unei clase. 
Pachetul java.lang este automat inclus în întregime. Acesta este motivul 
pentru care putem folosi prescurtări de genul Integer .parseInt (), Sys- 
tem.out,Math.max () etc. 


4.4.2 Instrucţiunea package 


Pentru a indica faptul că o clasă face parte dintr-un anumit pachet trebuie să 
realizăm două lucruri. În primul rând trebuie să scriem o instrucţiune package 
pe prima linie, înainte de a declara clasa. Apoi, va trebui să plasăm clasa în 
directorul corespunzător. Mai multe detalii veţi găsi în cadrul secţiunii C.2 a 
anexei C. 


4.4.3 Variabila sistem CLASSPATH 


Compilatorul şi interpretorul Java caută automat pachetele şi clasele Java în 
directoarele care sunt precizate în variabila sistem CLASSPATH. Ce înseamnă 
aceasta? Iată o posibilă setare pentru CLASSPATH, mai întâi pentru un sistem 
de operare Windows 95/98/2000, iar apoi pentru un sistem Unix/Linux: 


SET CLASSPATH=.;c:jdk1.4N1Libi 
export CLASSPATH=. :/usr/local/jăk1.4/1lib:ȘHOME/ 
javawork 


În ambele cazuri variabila CLASSPATH conţine directoarele (sau arhivele) 
care conţin programele compilate având extensia .class. De exemplu, dacă 
variabila CLASSPATH nu este setată corect, nu veţi putea compila nici măcar 
cel mai banal program Java, deoarece pachetul java. lang nu va fi găsit. O 
clasă care se află în pachetul P va trebui să fie pusă într-un director cu numele 
P care să se afle într-un director din CLASSPATH. Directorul curent (.) este 
întotdeauna în variabila CLASSPATH, deci dacă lucraţi într-un singur director 
principal, puteţi crea subdirectoarele chiar în el. Totuşi, în majoritatea situați- 
ilor, veţi dori să creaţi un subdirector Java separat şi să creaţi directoarele pentru 
pachete în acel subdirector. În această situaţie va trebui să adăugaţi la variabila 
CLASSPATH acest director. Acest lucru a fost realizat în exemplul de mai 
sus prin adăugarea directorului ȘHOME / javawork la CLASSPATH (notația 
$HOME, familiară utilizatorilor de Linux, reprezintă în acest context un alias 
pentru un director propriu-zis; de exemplu, /home/george). Utilizatorii de 
Windows pot adapta la fel de uşor variabila sistem CLASSPATH conform nece- 
sităţilor lor. Odată aceste modificări încheiate, în directorul javawork veţi 
putea crea subdirectorul io. În subdirectorul io vom plasa codul pentru clasa 
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Reader. Clasa Reader este o clasă ajutătoare, care ne permite să citim foarte 
comod, variabile de tip int, char, String, float şi chiar şiruri de numere 
întregi. Exemplele din volumul al doilea al cărţii vor utiliza intensiv această 
clasă utilitară. 

Codul sursă al clasei este prezentat în Listing 4.4 (detalii despre instrucţi- 
unea try-catch vom prezenta în capitolul 6, iar despre clasele de intrare/ieşire 
în capitolul 7). 

O aplicaţie va putea în această situaţie să folosească metoda readInt () 
fie prin 

int x = io.Reader.readint(); 
sau pur şi simplu prin 


int x = Reader.readlnt(); 


dacă se furnizează directiva import corespunzătoare. 


Listing 4.4: Clasa Reader 


ı package io; 

2 //clasa va trebui salvata intr-un director cu numele "io" 
3 //directorul in care se afla "io" va trebui adaugat 
4 //in CLASSPATH 

s import java.io.x; 
6 import java.util. StringTokenizer; 
7 public class Reader 

8 
9 


{ 
public static String readString() 


10 { 


T BufferedReader in = new BufferedReader ( 


12 new InputStreamReader (System .in )); 
13 try 
14 { 
I5 return in.readLine (); 
16 } 
17 catch (IOException e) 
18 { 
19 // ignore 
20 } 
21 return null; 
22 } 
23 
24 public static int readInt() 
25 { 
26 return lInteger.parselnt(readString ()); 
27 
) 


29 public static double readDouble() 


30 { 
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) 


return Double.parseDouble(readString ()); 


public static char readChar() 


{ 


} 


BufferedReader in = new BufferedReader ( 
new InputStreamReader (System .in )); 

try 

{ 


return (char )in.read(); 


catch (IOException e) 


{ 
// ignore 


} 


return '10'; 


public static int[] readIntArray () 


{ 


String s = readString(); 


StringTokenizer st = new StringTokenizer(s); 


//aloca memorie pentru sir 
int[] a = new int[st.countTokens ()]; 


for (int i = 0; i < a.length; ++i) 


ali] = Integer.parseInt(st.nextToken ()); 


} 


return a; 


4.4.4 Reguli de vizibilitate package-friendly 
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Pachetele au câteva reguli de vizibilitate importante. În primul rând, dacă 


pentru un membru al unei clase nu se precizează nici un modificator de vi- 
zibilitate (public, protected sau private), atunci membrul respectiv 
devine (package) friendly. Aceasta înseamnă că acel câmp este vizibil doar 
pentru clasele din cadrul aceluiaşi pachet. Aceasta este o vizibilitate mai puțin 
restrictivă decât private, dar mai restrictivă decât public (care este vizibil 


şi pentru membrii din alte clase, chiar şi din pachete diferite). 
În al doilea rând, doar clasele public din cadrul unui pachet pot fi folosite 


din afara pachetului. Acesta este motivul pentru care am pus întotdeauna modi- 
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ficatorul public în faţa unei clase. Clasele nu pot fi declarate private sau 
protected (cu o singură excepţie: clasele interioare, despre care vom vorbi 
în capitolul următor). Accesul de tip friendly se extinde şi pentru clase. Dacă 
o clasă nu este declarată ca fiind de tip public, atunci ea va putea fi accesată 
doar de clasele din cadrul aceluiaşi pachet. 

Toate clasele care nu fac parte din nici un pachet, dar sunt accesibile fiind 
puse într-un director din CLASSPATH, sunt considerate automat ca făcând parte 
din acelaşi pachet implicit. Ca o consecinţă, accesul de tip friendly se aplică 
pentru toate aceste clase. Acesta este motivul pentru care vizibilitatea nu este 
afectată dacă omitem să punem modificatorul public în clasele care nu fac 
parte dintr-un pachet. Totuşi, această modalitate de folosire a accesului friendly 
nu este recomandată. 


4.4.5  Compilarea separată 


Atunci când o aplicaţie constă din mai multe fişiere sursă . java, fiecare 
fişier trebuie compilat separat. În mod normal, fiecare clasă este plasată într-un 
fişier . java propriu. Ca urmare a compilării vom obţine o colecţie de fişiere 
„class. Clasele sursă pot fi compilate în orice ordine. Pentru a compila 
toate fişierele sursă dintr-un director printr-o singură comandă, puteţi folosi o 
extensie a comenzii javac, astfel: 


javac *.java 


4.5 Alte operaţii cu obiecte şi clase 


În această secțiune vom prezenta încă trei cuvinte cheie importante: this, 
instanceof şi static. this are mai multe utilizări în Java. Două din- 
tre ele le vom prezenta în această secțiune. instanceof are şi el mai multe 
utilizări; îl vom folosi aici pentru a ne asigura că o conversie de tip se poate re- 
aliza. Şi cuvântul cheie static are mai multe semnificaţii. Vom vorbi despre 
metode statice, atribute statice şi iniţializatori statici. 


4.5.1  Referinţa this 


Cea mai cunoscută utilizare pentru this este ca o referinţă la obiectul 
curent. Imaginaţi-vă că this vă indică în fiecare moment locul unde vă aflaţi. 
O utilizare tipică pentru this este calificarea atributelor unei clase în cadrul 
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unei metode a clasei care primeşte parametri cu nume identic cu numele atri- 
butelor. De exemplu, în clasa Circle, din Listing 4.1, putem defini metoda 
setRadius astfel: 


1/xx* Modifica raza cercului. */ 
2 public void setRadius (double radius) 


3 { 

4 // radius este parametrul, 

5 // iar this. radius este atributul clasei 
6 this. radius = radius; 
7 


) 


În secvenţa de cod precedentă, pentru a face distincţie între parametrul 
radius şi atributul cu acelaşi nume (care este "ascuns" de către parametru) 
se foloseşte sintaxa this.radius pentru a referi atributul clasei. 

Un alt exemplu de folosire al lui this este pentru a testa că parametrul 
pe care o metodă îl primeşte nu este chiar obiectul curent. Să presupunem, de 
exemplu, că avem o clasă Account care are o metodă finalTransfer () 
pentru a transfera toată suma de bani dintr-un cont în altul. Metoda ar putea fi 
scrisă astfel: 


ı public void finalTransfer(Account account) 


2 { 

3 dollars += account. dollars ; 
4 account.dollars = 0; 
5 


} 
Să considerăm secvența de cod de mai jos: 


ı Account accountl ; 

2 Account account? ; 

ic N 

4 account? = accountl; 

s accountl. finalTransfer(account?2); 


Deoarece transferăm bani în cadrul aceluiaşi cont, nu ar trebui să fie nici 
o modificare în cadrul contului. Totuşi, ultima linie din finalTransfer () 
are ca efect golirea contului debitor, ceea ce va face ca suma din account2 
să fie nulă. O modalitate de a evita o astfel de situaţie este folosirea unui test 
pentru pseudonime (referinţe care indică acelaşi obiect): 


ı public void finalTransfer(Account account) 


2 { 
//daca se incearca un transfer in acelasi cont 
if (this == account) 


{ 
} 


return ; 


w% N A a A V 
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9 dollars += account. dollars; 
10 account.dollars = 0; 


u} 


4.5.2 Prescurtarea this pentru constructori 


Multe clase dispun de mai mulți constructori care au un comportament si- 
milar. Putem folosi this în cadrul unui constructor pentru a apela ceilalți 
constructori ai clasei. De exemplu, o altă posibilitate de a scrie constructorul 
fără parametri pentru clasa Date este: 


ı public Date() 
2 | 
3 // apeleaza constructorul Dateţint, int, int) 
4 this (1, 1, 2000); 
5 
) 


Se pot realiza şi exemple mai complicate, dar întotdeauna apelul lui this 
trebuie să fie prima instrucţiune din constructor, celelalte instrucţiuni fiind în 
continuarea acesteia. 


4.5.3 Operatorul instanceof 


Operatorul instanceof realizează o testare de tip în timpul execuţiei. 
Rezultatul expresiei: 


exp instanceof NumeClasa 


este true dacă exp este o instanţă a lui NumeClasa şi false în caz contrar. 
Dacă exp este null, rezultatul este întotdeauna false. instanceof este 
folosit de obicei înainte de o conversie de tip, şi adeseori este folosit în legătură 
cu referinţele polimorfice pe care le vom prezenta în capitolul următor. 


4.5.4  Iniţializatori statici 


Atributele statice sunt inițializate atunci când clasa este încărcată în memo- 
rie. Uneori este însă nevoie de o inițializare mai complexă a acestor atribute. 
Să presupunem de exemplu că avem nevoie de un şir static care specifică pentru 
fiecare număr între 0 şi 100 dacă este număr prim sau nu. O posibilitate ar fi să 
definim o metodă statică şi să cerem programatorului să apeleze acea metodă 
înainte de a folosi şirul. 

O alternativă mai elegantă la această soluţie este folosirea inifializatorului 
static. Instrucţiunile din cadrul iniţializatorului static sunt executate automat la 
încărcarea clasei în memorie (deci înainte de a fi creată prima instanţă), ceea 
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ce ne asigură că atributele statice sunt corect iniţializate la utilizarea clasei. Un 
exemplu este prezentat în Listing 4.5. Aici iniţializatorul static se extinde de la 
linia 5 la linia 20. Iniţializatorul static trebuie să urmeze imediat după membrul 
static. 


Listing 4.5: Clasa Prime, care foloseşte o secvenţă statică de iniţializare 


public class Prime 
{ 


1 

2 

3 private static boolean prime[] = new boolean [100]; 
4 

5 static 

6 { 

7 for (int i = 2; i < prime.length; ++i) 
8 { 

9 prime[i] = true; 

10 for (int j = 2; j <= i/2; ++j) 
LI { 

12 if (i % j == 0) 

13 { 

14 prime[i] = false; 

15 break; 

16 } 

17 } 

18 

19 } 

20 } 

21 // restul clasei 

22 } 

Rezumat 


Acest capitol descrie noțiunile de obiect şi clasă, precum şi elementele fun- 
damentale legate de acestea, cum ar fi atribute, metode, constructori, reguli de 
vizibilitate şi pachete. Clasa este mecanismul prin care Java permite crearea de 
noi tipuri referință. Pachetele sunt folosite pentru a grupa clase cu comporta- 
ment similar. Pentru o mai bună înțelegere a pachetelor şi a modului de operare 
cu ele vă invităm să consultați anexa C. Tot acolo veți afla că toate clasele 
care compun o aplicație pot fi grupate într-un singur fişier, indiferent dacă sunt 
organizate pe pachete sau nu. Rezultatul va fi o arhivă jar. 

Capitolul următor prezintă alte concepte importante ale programării orien- 
tate pe obiecte: moştenirea, polimorfismul, programarea generică. 
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Noţiuni fundamentale 


clasă: concept care grupează atribute şi metode care sunt aplicate instanţelor 
clasei. 

CLASSPATH: variabilă sistem care specifică directoarele şi fişierele arhive 
în care maşina virtuală JVM caută clasele folosite de aplicaţiile Java. 

constructor: metodă specială responsabilă cu crearea şi iniţializarea de noi 
instanţe ale clasei. 

constructor this: folosit pentru a apela un alt constructor din aceeaşi 
clasă. 

friendly: tip de acces prin care clasele/metodele/atributele asociate nu sunt 
accesibile decât în interiorul pachetului din care fac parte. 

import: instrucţiune prin care se oferă o prescurtare pentru un nume com- 
plet de clasă (numele complet include şi pachetul din care provine clasa). 

iniţializator static: secvenţă din cadrul unei clase care permite iniţializarea 
atributelor statice. 

obiect: instanţă a unei clase. 

pachet: termen folosit pentru a organiza colecţii de clase cu comportament 
similar. 

package: instrucţiune care indică faptul că o clasă este membră a unui 
pachet. Trebuie să preceadă definirea unei clase. 

private: tip de acces prin care atributele/metodele sunt complet ascunse 
celorlalte clase, putând fi utilizate doar în cadrul clasei din care fac parte. 

public: tip de acces prin care atributele/metodele unei clase sunt vizibile 
în restul claselor. 

referinţa this: referinţă către obiectul curent. 

static: cuvânt cheie prin care se precizează faptul că o metodă sau un 
atribut sunt comune pentru toate instanțele clasei. Membrii statici nu necesită o 
instanţă pentru a fi accesaţi. 


Erori frecvente 


1. Membrii private nu pot fi accesaţi din afara clasei. Reţineţi că, im- 
plicit, membrii unei clase sunt friendly. Ei sunt vizibili doar în cadrul 
pachetului. 


2. Folosiţi public class în loc de class, cu excepţia situaţiei în care 
scrieţi o clasă ajutătoare de care nu veţi mai avea nevoie în afara pachetu- 
lui. 
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. Parametrul formal al metodei egua1s trebuie să fie de tip Object. În 


caz contrar, deşi programul se va compila, în anumite situaţii se va apela 
metoda equals implicită (care compară obiectele folosind ==). 


. Metodele statice nu pot accesa atributele nestatice fără un obiect care să 


le controleze. 


. Deseori se uită adăugarea " . * " atunci când se doreşte importarea tuturor 


claselor dintr-un pachet. 


„ Clasele care fac parte dintr-un pachet trebuie să se afle într-un director cu 


acelaşi nume ca cel al pachetului şi care să poate fi "accesat" din cadrul 
variabilei de sistem CLASSPATH. 


Exerciţii 


Pe scurt 


4. 


5. 


„ Ce înseamnă ascunderea informaţiei? Ce este încapsularea? Cum suportă 


Java aceste concepte? 


. Explicaţi secţiunile public şi private ale unei clase. 


. Descrieţi rolul unui constructor. 


Dacă o clasă nu are nici un constructor, ce va face compilatorul? 


Ce înseamnă accesul de tip "package friendly"? 


Teorie 


i 


Să presupunem că funcția main din Listing 4.2, ar fi făcut parte din clasa 
Circle. 


e Ar fi funcționat programul? 


e Am fi putut decomenta linia 15 din metoda main () fără a genera 
erori? 


In practică 


l. 


Creați o clasă cu un constructor implicit (fără parametri) care afişează un 
mesaj. In cadrul metodei main (), creaţi o instanţă a clasei şi verificaţi 
dacă mesajul a fost afişat. 


111 


4.5. ALTE OPERAŢII CU OBIECTE ŞI CLASE 


2. Adăugaţi clasei precedente un constructor care primeşte un parametru de 
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tip String, şi care afişează parametrul primit alături de mesajul ante- 
rior. Creați câte o instanţă a clasei folosind ambii constructori şi verificaţi 
mesajele afişate. 


Creați un şir de obiecte de tipul celor de la exerciţiul anterior, fără a crea 
însă obiectele pe care le referă elementele şirului. Verificaţi dacă mesajele 
din constructor sunt afişate. Încercaţi acum să creaţi câte un obiect pentru 
fiecare element din şir şi observați diferenţele. 


Definiţi o clasă fără nici un constructor iar apoi în main () creaţi o in- 
stanţă a clasei respective pentru a verifica faptul că se creează automat un 
constructor implicit. Adăugaţi apoi clasei un constructor cu un parametru 
de tip int, lasând metoda main () nemodificată. Programul nu se va 
mai compila. De ce? 


Creați o clasă fără nici un constructor care să aibă un atribut de tip int, 
unul de tip float, unul de tip boolean şi unul de tip String. Creați 
o instanţă a clasei şi afişaţi valorile acestor atribute pentru a verifica iniţi- 
alizările implicite. 


Un lacăt cu cifru are următoarele proprietăţi: combinaţia cifrelor (o sec- 
venţă de trei numere) este ascunsă; lacătul poate fi deschis prin furnizarea 
combinației corecte; combinaţia poate fi modificată, dar numai de către 
cineva care cunoaşte combinaţia corectă. Proiectaţi o clasă care să de- 
finească metodele publice open () şi changeCombo () şi câmpuri de 
tipul private care să reţină combinaţia. Combinația va trebui stabilită 
în constructor. 


Scrieţi o metodă care crează şi iniţializează o matrice de int cu valori 
aleatoare. Dimensiunile matricei, precum şi intervalul în care pot lua 
valori elementele matricei sunt date ca parametru. Adăugaţi o a doua 
metodă care afişează pe ecran matricea linie cu linie. Verificaţi cele două 
metode în main () iniţializând şi afişând matrice de diverse dimensiuni. 
Încercaţi apoi să extindeţi clasa pentru matrice cu trei dimensiuni. 


Creați o clasă care să conţină membri de tip private, public şi 
friendly. Creați apoi în cadrul altei clase o instanţă a clasei şi observați 
mesajele de eroare pe care le obţineţi de la compilator încercând acce- 
sarea diverşilor membri. Ţineţi cont de faptul că clasele care nu sunt 
declarate ca făcând parte dintr-un anumit pachet, fac toate parte din ace- 
laşi pachet implicit. Încercaţi acum să plasați cele două clase în pachete 
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diferite şi observați diferenţele între mesajele de eroare afişate la compi- 
lare. 


Proiecte de programare 


1. Scrieţi o clasă care suportă numere raţionale. Atributele clasei ar trebui să 
fie două variabile de tip long, una pentru numitor şi alta pentru numără- 
tor. Stocaţi numărul sub formă de fracţie ireductibilă, cu numitorul po- 
zitiv. Furnizaţi un număr rezonabil de constructori, precum şi metodele 
add (), subtract (),multiply(), divide (); de asemenea, me- 
todele toString (),equals () şi compareTo () (care se comportă 
ca cea din clasa String). Asiguraţi-vă că toString () funcţionează 
şi în cazul în care numitorul este zero. 


2. Implementaţi o clasă pentru numere complexe, Complex. Adăugaţi ace- 
leaşi metode ca şi la clasa Rational, dacă au sens (de exemplu, metoda 
comparetTo () nu are sens aici). Adăugaţi accesori pentru partea reală 
şi cea imaginară. 


3. Implementaţi o clasă completă Int Type care să suporte un număr rezo- 
nabil de constructori şi metodele add (), subtract (),multiply(), 
divide (), equals (), compareTo () şi toString(). Menţineţi 
IntType sub forma unui şir de cifre suficient de mare. Pentru această 
clasă operaţia dificilă este împărţirea, urmată îndeaproape de înmulţire. 


4. Implementaţi o clasă simplă numită Date. Clasa va trebui să reprezinte 
orice dată între 1 Ianuarie 1800 şi 31 Decembrie 2500; scădeţi două date; 
incrementaţi o dată cu un număr de zile; comparaţi două date folosind 
metodele equals () şi compareTo (). O dată este reprezentată intern 
ca numărul de zile care au trecut de la o anumită dată, care în cazul nostru 
este prima zi din 1800. Având în vedere acest lucru, toate metodele, mai 
puţin constructorul şi toString () vor fi banale. 


Indicaţie 

Regula pentru ani bisecți este: un an este bisect dacă este divizibil prin 4, 
dar nu prin 100 sau dacă este divizibil cu 400. Astfel 1800, 1900, 2100 
nu sunt ani bisecți, dar 2000 este. Constructorul trebuie să verifice va- 
liditatea datei, ca şi toString (). Data ar putea deveni incorectă dacă 
operatorul de incrementare sau scădere ar face-o să iasă din limitele spe- 
cificate. 

Odată ce am decis asupra specificaţiei, putem trece la implementare. 
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Partea oarecum dificilă este conversia între reprezentarea internă şi cea 
externă a datei. Urmează acum un posibil algoritm. 

Creați două şiruri care să fie atribute statice. Primul şir, pe care îl putem 
numi zilePanalalIntaiALunii va avea 12 elemente, reprezentând 
numărul de zile până la prima zi din fiecare lună a unui an nebisect. Ast- 
fel, el va conţine 0, 31, 59, 90 etc. Cel de-al doilea şir, zilePanaLlalIan 
va conţine numărul de zile până la începtul fiecărui an, începand cu 1800. 
Astfel, el va conţine 0, 365, 730, 1095, 1460, 1826 etc, deoarece 1800 nu 
este an bisect, dar 1804 este. Programul va trebui să iniţializeze acest şir 
o singură dată folosind un iniţializator static. Veţi putea apoi folosi acest 
şir pentru conversia din reprezentarea internă în reprezentarea externă. 


5. Moștenire 


Ştiinţă este orice disciplină în care 
nebunul generaţiei actuale poate să 
treacă dincolo de punctul atins de 
geniul generaţiei anterioare. 


Max Gluckman 


Aşa cum am menţionat în capitolul anterior, unul dintre principalele sco- 
puri ale programării orientate pe obiecte este reutilizarea codului. La fel cum 
inginerii folosesc aceleaşi componente din nou şi din nou în proiectarea cir- 
cuitelor, programatorii au posibilitatea să refolosească şi să extindă obiectele, 
în loc să le reimplementeze. În limbajele de programare orientate pe obiecte, 
mecanismul fundamental pentru refolosirea codului este moştenirea. Mogşteni- 
rea ne permite să extindem funcţionalitatea unui obiect. Cu alte cuvinte, putem 
crea noi obiecte cu proprietăţi extinse (sau restrânse) ale tipului original, for- 
mând astfel o ierarhie de clase. De asemenea, aşa cum vom vedea pe parcursul 
acestui capitol, moştenirea este mecanismul pe care Java îl foloseşte pentru a 
implementa metode şi clase generice (vezi subcapitolul 5.6). 

În acest capitol vom prezenta: 


e Principiile generale ale moştenirii, inclusiv polimorfismul; 


Cum este implementată moştenirea în Java; 


e Cum poate fi derivată o colecţie de clase dintr-o singură clasă abstractă; 


Interfața, care este un caz particular de clasă; 


Cum se poate realiza programarea generică în Java folosind interfeţe; 


Ce sunt şi cum se folosesc clasele interioare; 
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e Cum se pot identifica tipurile de date în faza de execuţie a programului 
(engl. RunTime Type Identification, RTTI). 


5.1 Ce este moştenirea? 


Moștenirea este principiul fundamental al programării orientate pe obiec- 
te care permite refolosirea codului între clasele înrudite. Moştenirea modelează 
relaţii de tipul ESTE-UN (sau ESTE-O). Într-o relaţie de tip ESTE-UN, spunem 
despre clasa derivată că ESTE-O variaţiune a clasei de bază. De exemplu, Cerc 
ESTE-O Curba, iar Masina ESTE-UN Vehicul. În schimb, o Elipsa 
NU-ESTE-UN Cerc. Relaţiile de moştenire formează ierarhii. De exemplu, 
putem extinde clasa Masina la MasinasStraina (pentru care se plăteşte 
vamă) şi MasinaAutohtona (pentru care nu se plăteşte vamă) etc. 

Un alt tip de relaţie între obiecte este relaţia ARE-UN sau ESTE-COMPUS- 
DIN. De exemplu, Masina ARE-UN Volan. Această relaţie nu are propri- 
etăţile standard dintr-o ierarhie de moştenire, motiv pentru care nu trebuie mo- 
delată prin moştenire, ci prin agregare, componentele devenind simple câmpuri 
de up private ale clasei. 

Chiar şi J2SDK foloseşte din plin moştenirea pentru a-şi implementa pro- 
priile biblioteci de clase. Un exemplu relativ familiar îl constituie excepţiile, 
prezentate pe larg în capitolul următor. Java defineşte clasa Exception. Aşa 
cum am văzut deja, există mai multe tipuri de excepţii, printre care putem aminti 
NullPointerException şi ArrayIlndex0utOfBoundsException. 
Fiecare excepţie constituie o clasă separată, dar ele au totuşi trăsături comune, 
cum ar fi de exemplu metodele toSstring() sau printSstackTrace(), 
utilizate pentru a furniza mesaje de eroare utile în depanare. 

Mogştenirea modelează în acest caz o relaţie de tip ESTE-UN. De exemplu, 
NullPointerException ESTE-O Exception. Datorită relaţiei de tip 
ESTE-UN, proprietatea fundamentală a moştenirii garantează că orice metodă 
aplicabilă lui Exception poate fi aplicată şi lui Nul1lPointerException. 
Mai mult decât atât, un obiect de tip NullPointerException poate să fie 
referit de către o referinţă de tip Exception (reciproca nu este adevărată!). 
Prin urmare, deoarece metoda toString () este o metodă disponibilă în clasa 
Exception, vom putea întotdeauna scrie: 


public void printException (Exception e) 
{ 


l 

2 

3 if (e instanceof NullPointerException) 
a d 
5 

6 


System . out. printin(e.toString ()); 
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7} 


Dacă în faza de execuție e referă un obiect NullPointerException, 
atuncie.toString () este un apel corect. Funcție de modul de implementare 
al ierarhiei de clase, metoda toString () ar putea fi invariantă sau ar putea fi 
specializată pentru fiecare clasă distinctă. Atunci când o metodă este invariantă 
în cadrul unei ierarhii, adică are aceeaşi funcționalitate pentru toate clasele din 
ierarhie, nu mai este necesar să rescriem implementarea acelei metode pentru 
fiecare clasă (ea este pur şi simplu moştenită). 

Apelul lui toString () din exemplul de mai sus mai ilustrează un alt 
principiu important al programării orientate pe obiecte, cunoscut sub numele de 
polimorfism. O variabilă referință care este polimorfică poate să refere obiecte 
de tipuri diferite. Atunci când se aplică o metodă referinței, se selectează au- 
tomat operația adecvată pentru tipul obiectului care este referit în acel moment. 
În Java, toate tipurile referință sunt polimorfice. De exemplu, să presupunem 
că avem o referință e de tip Exception, căreia i se aplică toString (). 
În momentul execuţiei, maşina virtuală Java va vedea care este obiectul efec- 
tiv referit de e (care poate fi de exemplu NullPointerException sau 
ArithmeticException)şi va apela metoda toString () a acelui obiect. 
Acest proces este cunoscut sub numele de legare târzie sau legare dinamică 
(engl. “late binding”). Mai multe elemente despre polimorfism vom prezenta 
în paragraful 5.2.3. 

În cazul moştenirii avem o clasă de bază din care sunt derivate alte clase. 
Clasa de bază reprezintă temelia principiului de moştenire. O clasă derivată 
moşteneşte toate proprietățile clasei de bază, însemnând că toți membrii publici 
ai clasei de bază devin membri publici ai clasei derivate (şi membrii private 
sunt moşteniţi, dar aceştia nu sunt accesibili în mod direct). Clasa derivată 
poate să adauge noi atribute şi metode şi poate modifica semnificaţia metodelor 
moştenite. Fiecare clasă derivată este o clasă complet nouă. Clasa de bază nu 
este în nici un fel afectată de modificările aduse în clasele derivate. Astfel, la 
crearea clasei derivate este imposibil să se strice ceva în clasa de bază. 


O clasă derivată este compatibilă ca tip cu clasa de bază, ceea ce înseamnă 
că o variabilă referinţă de tipul clasei de bază poate referi un obiect al clasei 
derivate, dar nu şi invers. Clasele surori (cu alte cuvinte clasele derivate dintr-o 
clasă comună) nu sunt compatibile ca tip. 

Aşa cum am menţionat anterior, folosirea moştenirii generează de obicei 
o ierarhie de clase. Figura 5.1 prezintă o mică parte din ierarhia de excepţii a 
limbajului Java. Remarcaţi faptul că NullPointerExcept ion este indirect 
derivată din Exception. Acest lucru nu constituie nici o problemă, deoarece 
relaţiile de tipul ESTE-UN sunt tranzitive. Cu alte cuvinte, dacă X ESTE-UN 
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Y şi Y ESTE-UN Z, atunci X ESTE-UN Z. Ierarhia Exception ilustrează în 
acelaşi timp designul clasic în care se extrag caracteristicile comune în clasa de 
bază, urmând ca specializările să fie adăugate în clasele derivate. Într-o astfel de 
ierarhie, clasa derivată este o subclasă a clasei de bază, iar clasa de bază este o 
superclasă a clasei derivate. Aceste relaţii sunt tranzitive; mai mult, operatorul 
instanceof funcţionează pentru subclase. Astfel, dacă obj este de tipul X 
(şi nu e null), atunci expresia obj instanceof Z este adevărată. 


Figura 5.1: O parte a ierarhiei de excepţii a limbajului Java 


Throwable 


RuntimeException 


Arithmetic Exception NullFointerException 


In următoarele secțiuni vom examina următoarele probleme: 


e Care este sintaxa folosită pentru a deriva o clasă nouă dintr-o clasă de 
bază? 


e Cum afectează acest lucru statutul membrilor private sau public? 


e Cum precizăm faptul că o metodă este invariantă pentru o ierarhie de 
clase? 
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e Cum factorizăm aspectele comune într-o clasă abstractă, pentru a crea 
apoi o ierarhie? 


e Putem deriva o clasă nouă din mai multe clase (moştenire multiplă)? 


e Cum se foloseşte moştenirea pentru a implementa codul generic? 


Câteva dintre aceste subiecte sunt ilustrate prin implementarea unei clase Shape 
din care vom deriva clasele Circle, Square şi Rectangle. Ne vom folosi 
de acest exemplu pentru a vedea modalitatea în care Java implementează polimor- 
fismul, dar şi pentru a vedea cum poate fi folosită moştenirea pentru a imple- 
menta metode generice. 


5.2 Sintaxa de bază Java 


O clasă derivată moşteneşte toate proprietăţile clasei de bază. Clasa derivată 
poate apoi să adauge noi atribute, să redefinească metode sau să adauge noi 
metode. Fiecare clasă derivată este o clasă complet nouă. Aspectul general 
al unei clase derivate este prezentat în Listing 5.1. Clauza extends declară 
faptul că o clasă este derivată dintr-o (extinde o) altă clasă. 


Listing 5.1: Aspectul general al unei clase derivate 


public class Derived extends Base 
{ 


1 
2 

3 // membrii ( public sau protected) ai clasei Base care 

4 //nu sunt listati mai jos vor fi mosteniti nemodificati, 
5 //cu exceptia constructorului; 

6 

7 //membri public ai clasei Derived; 

8 // constructori, daca cel implicit nu este suficient; 

9 // metode din Base a caror implementare este 

10 // modificata ; 

11 // metode publice aditionale; 

12 

13 //membri private ai clasei Derived; 

14 // atribute si metode private; 


Iată o scurtă descriere a unei clase derivate: 


e În general, toate atributele sunt private, deci atributele suplimentare 
vor fi adăugate clasei derivate prin precizarea lor în secţiunea private; 


e Orice metodă non-private din clasa de bază care nu este precizată în 
clasa derivată este moştenită nemodificat, cu excepţia constructorilor; 
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e Orice metodă din clasa de bază care este definită în secţiunea public a 
clasei derivate este redefinită. Noua metodă va fi aplicată obiectelor din 
clasa derivată; 


e Metodele public din clasa de bază nu pot fi redefinite în secţiunea 
private a clasei derivate; 


e Clasei derivate îi putem adăuga metode suplimentare. 


5.2.1 Reguli de vizibilitate 


Ştim deja că orice membru care este declarat private este accesibil doar 
în cadrul metodelor clasei. Rezultă deci că nici un membru private din clasa 
de bază nu va fi direct accesibil în clasa derivată (el va putea fi accesat prin 
intermediul modificatorilor şi accesorilor moşteniţi de la clasa de bază). 

Există situaţii în care clasa derivată trebuie să aibă acces la membrii clasei 
de bază. Există două opţiuni pentru a realiza acest lucru. Prima este aceea de 
a utiliza accesul de tip public sau friendly. Totuşi, accesul de tip public 
permite accesul şi altor clase, pe lângă clasele derivate şi încalcă principiul as- 
cunderii informaţiei. Pe de altă parte, accesul de tip friendly funcţionează doar 
dacă clasa derivată este în acelaşi pachet cu clasa de bază, lucru care nu este 
obligatoriu (vezi capitolul 4.4.4). 

Dacă dorim să restrângem accesul unor membri, astfel încât ei să fie vizibili 
doar pentru clasele derivate, putem să îi declarăm ca fiind de tip protected. 
Un membru de tipprotectedesteprivate pentru toate clasele cu excepţia 
claselor derivate şi a claselor din acelaşi pachet. În consecinţă vizibilitatea 
membrilor de tip protected este mai lejeră decât a membrilor de tip pack- 
age friendly. Declararea atributelor ca fiind public sau protected încalcă 
principiile încapsulării şi ascunderii informaţiei, fiind folosită doar din motive 
de comoditate. De obicei, este preferabil să se scrie modificatori şi accesori 
(setter-i şi getter-i) sau să se folosească accesul de tip friendly. Totuşi, dacă o 
declaraţie protected vă scuteşte de scrierea de cod stufos, atunci se poate 
recurge la ea. 


5.2.2 Constructor şi super 


Fiecare clasă derivată trebuie să îşi definească proprii constructori. Dacă 
nu se scrie nici un constructor, Java va genera un constructor implicit fără 
parametri. Acest constructor va apela constructorul fără parametri al clasei de 
bază (dacă nu există, se obţine eroare la compilare!) pentru membrii care au fost 
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moşteniţi, după care va aplica iniţializarea implicită pentru atributele adăugate 
(adică 0/false pentru tipurile primitive şi null pentru tipurile referinţă). 

Construirea unui obiect al unei clase derivate are loc prin construirea prea- 
labilă a porțiunii moştenite (constructorul clasei derivate apelează automat con- 
structorul implicit al clasei de bază). Acest lucru este natural, deoarece principi- 
ul încapsulării afirmă că partea moştenită este o entitate unică, iar constructorul 
clasei de bază ne spune cum să iniţializăm această entitate. 

Constructorii clasei de bază pot fi apelaţi explicit prin metoda super (). 
Astfel, constructorul implicit pentru o clasă derivată are de fapt forma: 


1 public Derived () 
2 { 


3 super (); 


4) 


Metoda super poate fi utilizată şi pentru a apela constructori cu parametri. 
De exemplu, dacă avem o clasă de bază care are un constructor cu doi parametri 
de tip int, atunci constructorul clasei derivate va avea în general forma: 


public Derived(int x, int y) 
{ 


super(x, y); 
// alte instructiuni 


n A U N = 


Metoda super () poate să apară doar în prima linie dintr-un constructor. 
Dacă nu se face un apel explicit al lui super (), compilatorul va realiza au- 
tomat un apel al metodei super () fără parametri chiar la începutul construc- 
torului. Este important de remarcat că apelul implicit este către constructorul 
implicit (fără parametri) al clasei de bază. Dacă acest constructor nu există (să 
nu uităm că el se generează automat doar dacă nu există alţi constructori), se 
obţine eroare la compilare. De exemplu, clasa Base de mai jos defineşte un 
constructor cu un parametru de tip int: 


public class Base 
{ 


1 

2 

3 public Base(int x) 

a f{ 

5 System . out. println("Base(int) called.") ; 
6 

7 


) 
) 


Clasa Derived, extinde clasa Base, redefineşte constructorul cu parametru 
de tip int şi defineşte o metodă main () care creează un obiect de tip Derived: 


1 public class Derived extends Base 
2 { 
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public Derived( int x ) 
{ 


3 

4 

5 System . out. println ("Derived(int) called.") ; 
6 } 
7 

8 

9 


public static void main(String |] args) 


{ 


10 new Derived (2) ; 


11 ) 


Aparent, nimic nu este în neregulă cu aceste clase. Totuşi, construirea obiec- 
tului Derived, presupune construirea în prealabil a obiectului Base, pe care 
acesta îl extinde. Cum constructorul din Derived nu conţine un apel explicit 
al constructorului din Base, compilatorul va adăuga automat un apel către con- 
structorul implicit. Dar, surpiză! Acest constructor nu există şi nici nu a fost 
generat implicit, deci se va obţine o eroare la compilare, în care suntem anunţaţi 
cu părere de rău că “nu a fost găsit constructorul Base ()”. Corect este ca 
prima linie din constructorul clasei Derived să fie un apel către constructorul 
cu parametru de tip int din clasa Base: 


public Derived( int x ) 
{ 


1 

2 

3 super(x) ; 

4 System.out.printin("Derived(int) called.") ; 
5 


) 


La execuţia clasei Derived se va afişa în consolă: 
Base(int) called. 
Derived(int) called. 


5.2.3  Redefinirea metodelor. Polimorfism 


Polimorfismul, al treilea concept fundamental al programării orientate pe 
obiecte, alături de încapsulare şi moştenire, crează adeseori un anumit grad de 
confuzie în rândul programatorilor începători. Vom urmări în acest paragraf să 
clarificăm această importantă noţiune, lucru absolut necesar pentru o înţelegere 
profundă a programării orientate pe obiecte. 

Capacitatea de a asuma diferite forme poartă numele de "polimorfism". Apa 
oferă un bun exemplu de polimorfism în lumea reală: apare sub formă solidă 
(gheaţa), lichidă, sau gazoasă (vaporii de apă). În Java, polimorfismul înseamnă 
că o singură variabilă referinţă poate fi folosită pentru a desemna mai multe 
obiecte - instanţe ale unor clase similare! - în diferite momente ale execuţiei 


la se citi clase derivate direct sau indirect din aceeaşi clasă de bază. 
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unui program. Când o referinţă x este folosită pentru a invoca o metodă a 
unui obiect (de exemplu, x .metodaMea () ), metoda precisă care va fi apelată 


depinde de obiectul pe care variabila referinţă îl indică în acel moment. 


O variabilă referinţă poate referi un obiect a cărui clasă este similară cu 
tipul variabilei referinţă. De exemplu, să presupunem că avem clasele Animal, 


Pisica, Soarece, Caine, definite ca mai jos: 


Listing 5.2: Exemplu de polimorfism 


1 public class Animal 


2 

{ 

3 public String caracteristica () 
4 { 

5 return "necunoscuta"; 

6 } 

7) 

8 

o public class Soarece extends Animal 
10 { 

11 public String caracteristica () 
12 { 

13 return "are culoarea gri"; 


ı7 public class Pisica extends Animal 


18 

{ 

19 public String caracteristica () 
20 { 

21 return "miauna"; 

22 } 

23 } 


24 
25 public class Caine extends Animal 


26 { 

27 public String caracteristica) 
28 { 

29 return "latra"; 

30 } 


31) 
32 
33public class PolimorfismEx 


34 

{ 

35 public static void main(String args []) 

36 í 

37 Animal a = new Soarece(); 

38 System .out.println(" Caracteristica primului animal: 
39 a. caracteristica ()); 


40 
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41 //alte instructiuni... 

42 

43 a = new Caine); 

44 System .out.println(" Caracteristica celui de-al doilea" + 
45 " animal: " + a. caracteristica ()); 
46 

47 //alte instructiuni... 


Ceea ce atrage atenţia asupra acestui program este faptul că toate cele patru 
metode caracteristica () au aceeaşi semnătură (nume şi listă de parametri). 
Acest lucru este permis deoarece nu există două metode cu aceeaşi semnătură 
în aceeaşi clasă. Cum trei dintre aceste clase (Soarece, Caine, Pisica) 
extind o a patra clasă (Animal), spunem că metodele caracteristica () 
din clasele derivate redefinesc (engl. override) metoda caracteristica () 
din clasa de bază. 

Să analizăm acum instrucţiunea următoare: 


Animal a = new Soarece(); 


În această situaţie, variabila referinţă a care este de tipul Animal desem- 
nează un obiect de tipul Soarece, care ESTE-UN Animal prin moştenire 
(prin urmare, atribuirea este corectă). Mai departe, întâlnim în cadrul aceleiaşi 
secvenţe de cod: 


a = new Caine (); 


Cu alte cuvinte, variabila a referă (la momente diferite de timp) obiecte 
de tipuri diferite, dar similare (prin faptul că sunt derivate din aceeaşi clasă: 
Animal). Pentru a vă convinge de acest lucru, rulaţi acest program. El va afişa 
următorele date: 


Caracteristica primului animal: are culoarea gri 
Caracteristica celui de-al doilea animal: latra 


După cum se poate observa, apelurile metodei caracteristica (),prin 
intermediul referinţei a, au determinat apelarea metodelor corespunzătoare din 
clasele Soarece şi Caine (şi prin urmare, două afişări diferite), deoarece la 
momentul fiecărui apel, variabila a referea un obiect de tip diferit. Poate că unii 
dintre dumneavoastră se aşteptau ca singura metodă apelată să fie cea din clasa 
Animal, motiv pentru care rezultatul vi se pare anormal, dar el va fi perfect 
explicabil după ce vom detalia noţiunea de apel polimorfic al unei metode. 
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Ca o paranteză, trebuie remarcat faptul că inversarea rolurilor celor două 
clase nu este posibilă în cadrul acestui exemplu (normal de altfel, deoarece un 
animal nu este în mod obligatoriu un şoarece): 


Soarece s = new Animal(); //INCORECT... 


După cum am văzut anterior, în cadrul subcapitolului 5.1, moştenirea per- 
mite tratarea unui obiect ca fiind de tipul propriu sau de tipul de bază (din 
care este derivat tipul propriu). Această caracteristică este esenţială deoarece 
permite mai multor tipuri (derivate din acelaşi tip de date) să fie tratate uni- 
tar, ca şi cum ar fi un singur tip, motiv pentru care aceeaşi secvenţă de cod 
va fi funcţională pentru toate aceste tipuri. Pe de altă parte, apelul polimorfic 
al unei metode permite unui tip să exprime distincţia faţă de un alt tip simi- 
lar, atâta timp cât amândouă sunt derivate din aceeaşi clasă de bază. Distincția 
este exprimată prin diferenţa în comportamentul metodelor care pot fi apelate 
prin intermediul clasei de bază (în exemplul nostru, este vorba despre metoda 
caracteristica ()). 

Polimorfismul permite scrierea de cod doar în raport cu clasa de bază, ca şi 
cum ““am fi uitat” de clasele derivate. Totuşi, cei mai mulţi programatori, în spe- 
cial cei cu experienţă în programarea procedurală, întâmpină anumite dificultăți 
în înţelegerea modului de funcţionare a polimorfismului. 

Dificultatea poate fi întâlnită şi în cadrul programului din exemplul anterior. 
Afişarea celor două mesaje este evident cea dorită, deşi parcurgând codul sursă 
al programului, am putea avea impresia că programul nu va funcţiona în acest 
mod. Dacă privim mai atent linia 38, observăm că metoda caracteristica () 
este apelată prin intermediul unei referinţe de tipul Animal. Aşa că ne punem 
în mod logic întrebarea: este posibil să ştie compilatorul că variabila referinţă 
de tipul Animal referă un obiect de tipul Soarece, din moment ce se ape- 
lează metoda acesteia din urmă? De unde ştie compilatorul că este referit un 
obiect de tip Soarece, şi nu un obiect de alt tip (de exemplu, Pisica sau 
Caine)? Răspunsul este că, de fapt, compilatorul nu ştie acest lucru. Pentru 
a înţelege mai bine această problemă, este necesară o examinare mai atentă a 
noţiunii de legare. 

Conectarea unui apel de metodă de un anumit corp de metodă poartă numele 
de legare (engl. binding). Când legarea are loc înainte de rularea programului 
respectiv (cu alte cuvinte, în faza de compilare), spunem că este vorba despre o 
legare statică (engl. early binding). Termenul este specific programării orien- 
tate pe obiecte. În programarea procedurală (gen programarea în C sau Pascal), 
noţiunea de legare statică nici nu există, pentru că toate legăturile se fac în mod 
static. 

În programul anterior, compilatorul nu ştie ce metodă caracteristica () 
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(din clasa Animal, Soarece,Pisica sau Caine?) să apeleze, având doar o 
referință de tipul Animal. Soluţia constă însă în legarea târzie (engl. late bind- 
ing). Cunoscută şi sub numele de legare dinamică sau legare în faza de execuţie 
(engl. dynamic binding, run-time binding), legarea târzie permite determinarea 
în faza de execuţie a tipului obiectului referit de o variabilă referinţă şi apelarea 
metodei specifice acestui tip (în exemplul nostru, metoda caracteristica () 
din clasa Soarece). Mecanismul de apelare a metodelor determină în mod 
corect metoda care trebuie apelată şi o apelează. Legarea este un fenomen care 
are loc automat - nu este atribuţia programatorului să decidă dacă o metodă este 
apelată prin legare statică sau dinamică. 

Am ajuns la momentul în care trebuie să conturăm diferenţa dintre redefini- 
rea (suprascrierea) unei metode şi supraîncărcarea ei. Cu alte cuvinte, overrid- 
ing vs. overloading. Finalul capitolul 2, secţiunea 2.6, a prezentat noţiunea 
de supraîncărcare a metodelor. Recapitulând pe scurt informaţiile precizate 
acolo, supraîncărcarea metodelor permite existenţa în interiorul aceleaşi clase 
a mai multor metode cu acelaşi nume, dar cu lista diferită de parametri (prin 
urmare, cu semnături diferite). Astfel, putem avea o metodă int max(int 
a, int b) şiometodăint max(int a, int b, int c),ambele în 
cadrul aceleiaşi clase. Evident că, analog, putem avea prima metodă în cadrul 
unei clase de bază şi cea de-a doua în cadrul unei clase derivate din clasa de 
bază. Pe de altă parte, noţiunea de suprascriere (redefinire) se bazează tocmai 
pe ideea că metodele trebuie să aibe aceeaşi semnătură şi să se afle în clase 
derivate din clasa de bază (vezi exemplul din această secţiune). Diferenţa dintre 
cele două concepte este în acest moment clar definită. 

Cele două concepte pot provoca uneori greşeli de programare greu detec- 
tabile, în cazul în care nu sunt folosite corect. lată un exemplu sugestiv: să 
presupunem că metoda caracteristica () din clasa Soarece ar fi avut 
de fapt următoarea definire: 


public String caracteristica(int i) 


{ 


1 
2 
3 return "are blana gri"; 
4 


) 


Poate că acest antet ar fi fost o greşeală neintenţionată a programatorului, 
sau pur şi simplu, ar fi fost ceva intenţionat. Ce s-ar fi întâmplat în această situ- 
aţie la execuţia liniei 38 din exemplul nostru? Cert este că aceasta nu ar fi fost 
interpretată drept o eroare de către compilator. Programul ar fi rulat şi ar fi afişat 
rezultatele: 


Caracteristica primului animal: necunoscuta 
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Caracteristica celui de-al doilea animal: latra 


Poate că vi se pare ciudat rezultatul execuţiei versiunii modificate a pro- 
gramului. Să vedem ce s-a întâmplat de fapt. Deoarece în clasa Soarece, 
noua metodă caracteristica () are o semnătură diferită faţă de metoda 
cu acelaşi nume a clasei de bază, am realizat o supraîncărcare a acelei metode, 
şi nu o redefinire a ei. Astfel clasa Soarece are acum două metode ca- 
racteristica() diferite: una moştenită prin derivarea din clasa de bază 
şi cealaltă prin supraîncărcarea metodei din clasa de bază. În urma apelului 
din linia 38 se va executa însă metoda moştenită din clasa de bază, şi nu cea 
supraîncărcată, deoarece aceea corespunde ca semnătură. Astfel, mesajul afişat 
este “necunoscuta”. 

Deşi se intenţionase o redefinire a acelei metode, datorită faptului că s-a 
greşit la definirea antetului ei, rezultatul nu a fost cel aşteptat. Totuşi, compila- 
torul a presupus că intenţia a fost de a supraîncărca metoda şi nu de a o redefini, 
motiv pentru care nu a afişat nici o eroare. Evident că acesta nu este un apel 
polimorfic de metodă. Odată ce a fost depistată eroarea, ea poate fi înlăturată 
simplu, însă este infinit mai greu în cazul unor aplicaţii mai complexe. La fel de 
adevărat este faptul că uneori exact acest comportament este dorit. Programa- 
torii avansați vor şti cu siguranţă cum să “jongleze” cu cele două noţiuni. Cei 
începători vor trebui să fie foarte atenţi în astfel de situaţii, pentru a implementa 
exact comportamentul pe care îl doresc. 

Datorită polimorfismului, exemplul nostru poate fi extins, adăugând noi 
funcţionalităţi prin intermediul unor tipuri noi de date (clase) care moştenesc 
comportamentul clasei de bază. Altfel spus, putem adăuga clase noi ce extind 
comportamentul clasei Animal, fără ca aceasta să prejudicieze codul existent. 

Referitor la modul de utilizare a polimorfismului există o singură problemă 
ce trebuie tratată cu mare atenţie pentru că este generatoare de mari proble- 
me, greu detectabile mai ales în cadrul unor programe de dimensiuni mari: 
este vorba despre utilizarea metodelor polimorfice în cadrul constructorilor. 
Deoarece obiectele nu sunt complet construite în această fază a execuţiei unui 
program, ceea ce presupune că identificarea tipului obiectelor respective este 
problematică, apelul polimorfic al unor metode poate crea un comportament 
imprevizibil şi, în cele mai multe situaţii, nedorit. 

Polimorfismul presupune existenţa unei “feţe” (funcţionalitatea comună din 
clasa de bază) şi a mai multor “forme” care folosesc această faţă (diferitele 
funcţionalităţi ale metodelor legate dinamic). Reţineţi că polimorfismul apare 
doar atunci când este vorba despre legarea târzie a metodelor. Polimorfismul 
oferă o nouă viziune asupra modului de decuplare dintre ceea ce face o clasă şi 
cum îndeplineşte ea acest lucru. Polimorfismul realizează o decuplare la nivel 
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de tipuri. De asemenea, permite o bună organizare a codului, dar şi crearea de 
programe extensibile în adevăratul sens al cuvântului, care pot fi îmbunătăţite 
ca funcţionalitate nu numai în faza de creare a aplicaţiei, ci şi pe parcursul 
existenţei ei, când noi facilităţi sunt de dorit. 


5.2.4  Redefinirea parţială a metodelor 


Am văzut deja că metodele din clasa de bază pot fi redefinite în clasele 
derivate prin furnizarea unei metode din clasa derivată care să aibă aceeaşi sem- 
nătură. De asemenea, metoda din clasa derivată nu are dreptul să adauge ex- 
cepţii la lista throws (detalii despre throws în capitolul următor). 

Adeseori, metoda din clasa derivată nu redefineşte complet metoda din clasa 
de bază, ci extinde operaţiile pe care aceasta le realizează. Acest proces este 
numit redefinire parțială. Cu alte cuvinte vrem să facem ceea ce face şi metoda 
din clasa de bază, plus încă ceva. Apeluri ale metodei din clasa de bază pot fi 
realizate folosind din nou super. lată un exemplu: 


Listing 5.3: Exemplu de redefinire parțială 


public class Student extends Human 
{ 


l 
2 

3 public doWork() 

4 { 

5 takeBreak (); // pauzele lungi si dese 
6 super .doWork (); // cheia marilor 

7 takeBreak (); // succese 

8 ) 

9) 


Astfel, metoda doWork () din clasa Student extinde metoda doWork () 
din clasa Human, adăugându-i două elemente importante: pauza şi pauza... 
Apelul polimorfic se aplică în mod identic şi în cazul redefinirii parțiale. 


5.2.5 Metode şi clase final 


Aşa cum am precizat anterior, clasa derivată poate să redefinească sau să 
accepte nemodificate metodele din clasa de bază. În multe cazuri este clar faptul 
că o anumită metodă trebuie să fie invariantă de-a lungul ierarhiei de clase, ceea 
ce înseamnă că nici o clasă derivată nu trebuie să o redefinească. În acest caz, 
putem declara metoda ca fiind de tip final, iar ea nu va putea fi redefinită. 

Pe lângă faptul că declararea unei metode final este o practică bună de 
programare, ea poate genera şi cod mai rapid. Declararea unei metode final 
(atunci când este cazul) este utilă deoarece intenţiile noastre devin astfel clare 
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pentru cititorul programului şi al documentaţiei şi, pe de altă parte, putem pre- 
veni redefinirea accidentală pentru o metodă care nu trebuie să fie redefinită. 

Pentru a vedea de ce folosirea lui final poate conduce la cod mai efi- 
cient, să presupunem că avem o clasă de bază numită Base care defineşte o 
metodă finală f ( ), iar Derived este o clasă care extinde Base. Să conside- 
răm metoda: 


ı public void xxx(Base obj) 


2 { 
3 obj. f(); 


4) 


Deoarece f () este o metodă final, nu are nici o importanţă dacă în 
momentul execuţiei, obj referă un obiect de tip Base sau un obiect de tip 
Derived; definirea lui f este invariantă, deci ştim de la început ceea ce f va 
face. O consecinţă a acestui fapt este că decizia pentru codul care va fi exe- 
cutat se ia încă de la compilare, şi nu la execuție. Este vorba, în mod evident, 
de o legare statică. Deoarece legarea se face la compilare şi nu la execuţie, 
programul ar trebui să ruleze mai repede. Dacă acest fapt este sau nu percep- 
tibil efectiv (ţinând cont de viteza de prelucrare a procesoarelor din generaţia 
actuală) depinde de numărul de ori în care evităm deciziile din timpul execuţiei 
programului. În Java, orice legare de metode este polimorfică, prin intermediul 
legării târzii, cu excepţia situaţiei în care metoda este declarată final. 

Un corolar al acestei observaţii îl constituie faptul că dacă f este o metodă 
final banală, cum ar fi un accesor pentru un atribut, compilatorul ar putea 
să înlocuiască apelul lui f (), direct cu corpul funcţiei. Există foarte multe 
optimizări pe care le face compilatorul java pentru a mări eficienţa codului, iar 
aceasta este doar una dintre ele. Astfel, apelul funcţiei va fi înlocuit cu o singură 
linie care accesează un atribut, economisindu-se astfel timp (apelul unei metode 
şi transmiterea de parametri sunt operaţii destul de costisitoare). Dacă f () nu 
ar fi fost declarată final, acest lucru ar fi fost imposibil, deoarece obj ar fi 
putut referi un obiect al unei clase derivate, pentru care definirea lui f () ar fi 
putut fi diferită. 

Este interesant de remarcat faptul că, deoarece metodele statice nu au un 
obiect care să le controleze, apelul lor este rezolvat încă de la compilare folosind 
legarea statică. 

Similare metodelor final sunt clasele final. O clasă final nu mai 
poate fi extinsă. În consecinţă, toate metodele unei astfel de clase sunt automat 
metode final. Ca un exemplu, clasa Integer din pachetul java.lang 
este o clasă final. De remarcat faptul că dacă o clasă are doar membri 
final, ea nu este neapărat o clasă final. 
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5.2.6 Metode şi clase abstracte 


Până acum am văzut faptul că unele metode sunt invariante de-a lungul ie- 
rarhiei de clase (metodele final), iar alte metode îşi modifică semnificaţia 
de-a lungul ierarhiei. O a treia posibilitate este ca o metodă din clasa de bază să 
aibă sens doar pentru clasele derivate, şi vrem ca ea să fie obligatoriu definită 
în clasele derivate. Totuşi, implementarea metodei nu are nici un sens pentru 
clasa de bază. În această situaţie, putem declara metoda ca fiind abstractă. 

O metodă abstractă este o metodă care declară funcţionalităţi care vor tre- 
bui neapărat implementate până la urmă în clasele derivate. Cu alte cuvinte o 
metodă abstractă spune ceea ce obiectele derivate trebuie să facă. Totuşi, ea nu 
furnizează nici un fel de implementare, ci fiecare clasă derivată trebuie să vină 
cu propria implementare. 

O clasă care are cel puţin o metodă abstractă este o clasă abstractă. Java 
pretinde ca toate clasele abstracte să fie definite explicit ca fiind abstracte. Atunci 
când o clasă derivată nu redefineşte o metodă abstractă, metoda va fi moştenită 
abstractă şi în clasa derivată. În consecinţă dacă o clasă care nu intenţionăm 
să fie abstractă, nu redefineşte toate metodele abstracte, compilatorul va detecta 
inconsistenţa şi va genera un mesaj de eroare. 

Un exemplu simplu de clasă abstractă este clasa Shape (rom. formă sau 
curbă), pe care o vom folosi ca exemplu în cadrul acestui capitol. Din Shape 
vom deriva forme specifice cum ar fi Circle sau Rectangle. Putem deriva 
apoi Square ca un caz particular de Rectangle. Figura 5.2 prezintă ierarhia 
de clase care rezultă. 

Clasa Shape poate să aibă membri care să fie comuni pentru toate clasele. 
Într-un exemplu mai extins, aceasta ar putea include coordonatele extremităților 
obiectului. Clasa ar putea declara şi defini metode cum ar fi positionof, 
pentru a determina poziţia formei. Aceste metode sunt independente de tipul 
formei, motiv pentru care positionoOf ar fi o metodă final. Clasa de- 
fineşte metode care se aplică fiecărui obiect în parte. Unele dintre aceste metode 
nu au nici un sens pentru clasa abstractă Shape. De exemplu, este dificil de 
calculat aria unui obiect oarecare; în consecinţă metoda area va fi declarată 
abstract: 

Aşa cum am menționat anterior, existența a cel puțin o metodă abstractă, 
face clasa să devină şi ea abstractă, deci ea nu va putea fi instanțiată. Astfel, nu 
vom putea crea un obiect de tip Shape şi vom putea crea doar obiecte derivate. 
Totuşi, ca de obicei, o referinţă de tip Shape poate să refere orice formă con- 
cretă derivată, cum ar fi Circle sau Rectangle. Exemplu: 


Shape a,b; 
a = new Circle (3.0); // corect 
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Figura 5.2: Ierarhia de clase pentru forme 


F.ectangle 


b = new Shape("circle”); // INCORECT! 


Codul din Listing 5.4 prezintă clasa abstractă Shape. La linia 13, declarăm 
o variabilă de tip String care reţine tipul formei, folosită doar în clasele 
derivate. Atributul este de tip private, deci clasele derivate nu au acces direct 
la el. Restul clasei cuprinde o listă de metode. 

Constructorul nu va fi apelat niciodată direct, deoarece Shape este o clasă 
abstractă. Avem totuşi nevoie de un constructor care să fie apelat din clasele 
derivate pentru a iniţializa atributele private. Constructorul clasei Shape 
stabileşte valoarea atributului name. 

Linia 15 declară metoda abstractă area. area este o metodă abstractă, 
deoarece nu putem furniza nici un calcul implicit al ariei pentru o clasă derivată 
care nu îşi defineşte propria metodă de calcul a ariei. 

Metoda de comparaţie din liniile 22-25 nu este abstractă, deoarece ea poate 
fi aplicată în acelaşi mod pentru toate clasele derivate. De fapt, definirea ei este 
invariantă de-a lungul ierarhiei, de aceea am declarat-o final. Parametrul 
rhs (de la "right-hand-side”) reprezintă un alt obiect de tip Shape, a cărui 
arie se compară cu cea a obiectului curent. Este interesant de remarcat faptul 
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că variabila rhs poate să refere orice instanţă a unei clase derivate din Shape 
(de exemplu o referinţă a clasei Rectangle). Astfel este posibil ca folosind 
această metodă să comparăm aria obiectului curent (care poate fi, de exemplu, 
o instanţă a clasei Circle) cu aria unui obiect de alt tip, derivat din Shape. 
Acesta este un exemplu excelent de folosire a polimorfismului. 

Metoda toString din liniile 27-30 afişează numele formei şi aria ei. Ca şi 
metoda de comparaţie lessThan, ea este invariantă de-a lungul ierarhiei (nu 
face decât să concateneze două stringuri, indiferent de natura formei), de aceea 
a fost declarată final. 


Listing 5.4: Clasa de bază abstractă Shape 


/x Clasa de baza abstracta pentru forme 


1 
2 * 

3 x» CONSTRUIREA: nu este permisa, Shape fiind abstracta. 

4 x Constructorul cu un parametru este furnizat ptr. clasele 
5 * derivate. 

6 x———————— metode publice 

7 * double area() ——> Intoarce aria (abstracta) 

s * boolean lessThan ——> Compara doua forme dupa arie 

9 x* String toString ——> Metoda uzuala pentru scriere 

10 */ 

n abstract class Shape 

2 f 

13 private String name; 

14 

15 abstract public double area); 


17 public Shape( String shapeName) 
18 { 


19 name = shapeName; 
20 } 


22 final public boolean lessThan (Shape rhs) 
23 { 

24 return area() < rhs.area(); 

25 } 


27 final public String toString() 


28 { 
29 return name + ", avand aria 


30 } 


au) 


Inainte de a trece mai departe, să rezumăm cele patru tipuri de metode ale 
unei clase: 


te 


+ area (); 


1. Metode finale. Apelul lor este rezolvat încă de la compilare. Folosim 
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metode final doar atunci când metoda este invariantă de-a lungul ie- 
rarhiei (adică atunci când metoda nu este niciodată redefinită); 


2. Metode abstracte. Apelul lor este rezolvat în timpul execuţiei. Clasa 
de bază nu furnizează nici o implementare a lor şi este abstractă. Clasele 
derivate trebuie fie să implementeze metoda, fie devin ele însele abstracte; 


3. Metode statice. Apelul este rezolvat la compilare, deoarece nu există 
obiect care să le controleze; 


4. Alte metode. Apelul este rezolvat la execuţie. Clasa de bază furnizează o 
implementare implicită care fie va fi redefinită (parţial sau total) în clasele 
derivate, fie acceptată nemodificată. 


5.3 Exemplu: Extinderea clasei Shape 


In această secţiune vom implementa clasele derivate din clasa Shape şi 
vom prezenta cum sunt ele utilizate într-o manieră polimorfică. Iată enunţul 
problemei: 


Sortare de forme. Se citesc N forme (cercuri, dreptunghiuri sau pătrate). 
Să se afişeze formele ordonate după arie. 


Implementarea claselor Circle, Rectangle şi Square, prezentată în 
Listing 5.5 este simplă şi nu ilustrează aproape nici un concept pe care să nu-l 
fi prezentat deja. Singura noutate este că clasa Square este derivată din clasa 
Rectangle care este, la rândul ei, derivată din Shape. La implementarea 
fiecărei dintre aceste clase trebuie: 


1. să definim un nou constructor; 


2. să examinăm fiecare metodă care nu este final sau abstract pentru 
a vedea dacă dorim să o acceptăm nemodificată. Pentru fiecare astfel de 
metodă care nu corespunde cu necesităţile clasei trebuie să furnizăm o 
nouă definire; 


3. să definim fiecare metodă abstractă; 


4. să adăugăm alte metode dacă este necesar. 
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Listing 5.5: Codul complet pentru clasele Circle, Rectangle şi Square, 
care va fi salvat în 3 fişiere sursă separate 


1 /x clasele Circle, Square si Rectangle; 

2 * toate sunt derivate din Shape 

3 * 

4 * CONSTRUCTORI: (a) cu raza ptr. cerc, (b) cu latura 

5 * ptr. patrat, (c) cu lungime si latime ptr. dreptunghi 

6 x———— ————Hietode: publice 

7 * double area()——>Implementeaza metoda abstracta din Shape 
8 * 

9 x» ATENTIE: Fisierul trebuie separat in 3 pentru compilare! 
10 */ 

u public class Circle extends Shape 

12 { 


13 private double radius; 


15 public Circle(double rad) 
16 { 


17 super("Circle"); 
18 radius = rad; 


19 } 


21 public double area() 


22 { 
23 return Math.PI + radius + radius; 
24 } 


25 } 


27 public class Rectangle extends Shape 
28 | 

29 private double length; 

30 private double width ; 


32 public Rectangle (double len, double wid) 


33 

{ 
34 this(len, wid, "Rectangle" ); 
35 } 
36 
37 Rectangle (double len, double wid, String name) 
38 { 
39 super (name ); 
40 length = len; 
41 width = wid; 
42 } 
43 
44 public double area () 
45 { 
46 return length » width; 
47 

} 


5.3. EXEMPLU: EXTINDEREA CLASEI SHAPE 


48 ] 
49 
ss public class Square extends Rectangle 


sı { 
52 public Square (double side) 


53 í 
54 super( side, side, "Square" ); 
55 } 


Pentru fiecare clasă am scris un constructor public simplu care permite iniți- 
alizarea cu dimensiunile de bază (rază pentru cercuri, lungimea laturilor pentru 
dreptunghiuri şi pătrate). Pentru clasa Rectangle a fost necesar şi un con- 
structor package-friendly, care să permită crearea unui obiect Square, cu nu- 
mele corespunzător. Drept urmare, constructorul public al clasei Rectangle 
este şi el adaptat, apelând de fapt constructorul package-friendly din aceeaşi 
clasă. 

În constructorul public, vom iniţializa mai întâi partea moştenită prin apelul 
lui super. În cazul clasei Rectangle acest apel nu este direct, ci prin inter- 
mediul constructorului package-friendly. Fiecare clasă trebuie să definească o 
metodă area (), deoarece Shape a declarat-o ca fiind abstractă. Dacă uităm 
să scriem o metodă area pentru una dintre clase, eroarea va fi detectată încă de 
la compilare, deoarece - dacă metoda area () lipseşte - atunci clasa derivată 
este şi ea abstractă. Observaţi că Square este dispusă să accepte metoda 
area () moştenită de la Rectangle, de aceea nu o mai redefineşte. Logi- 
ca acestei abordări derivă din faptul că aria unui pătrat se calculează exact ca şi 
aria unui dreptunghi, prin produsul lungimii a două laturi alăturate. 

După ce am implementat clasele, suntem gata să rezolvăm problema or- 
donării, iar pentru aceasta vom folosi un şir de clase Shape. Reţineţi faptul că 
prin aceasta nu alocăm memorie pentru nici un obiect de tip Shape (ceea ce ar 
fi ilegal deoarece Shape este clasă abstractă), ci se alocă memorie doar pentru 
un şir de referinţe către Shape. Aceste referinţe vor putea referi obiecte de tip 
Circle, Rectangle sau Square?. 

În Listing 5.6 realizăm exact acest lucru. Mai întâi citim obiectele. La 
linia 21, apelul lui readShape () constă în citirea unui caracter, urmată de 
dimensiunile figurii şi de crearea unui nou obiect de tip Shape. Listing 5.7 
prezintă o implementare primitivă a acestei rutine. Observaţi că în cazul unei 
erori la citire se creează un cerc de rază 0 şi se întoarce o referinţă la el. O soluţie 
mai elegantă în această situaţie ar fi fost să definim şi să aruncăm o excepţie. 


Nici nu se poate inventa o ilustrare mai bună pentru polimorfism (poli = mai multe, morphos = 
forme). Într-adevăr referinţa de tip Shape (shape = formă) poate referi clase de mai multe (poli) 
forme (morphos): Circle, Rectangle şi Square. 
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După aceasta, fiecare obiect creat de către readShape () este referit de 
către un element al şirului shapes. Se apelează insertionsort () (Listing 
5.8) pentru a sorta formele. În final afişăm şirul rezultat de forme, apelând astfel 
implicit metoda toSstring(). 


Listing 5.6: Rutina main () pentru citirea de figuri şi afişarea lor în ordine 
crescătoare 

ı import java.io.x ; 

2 

3 class TestShape 


al 


5 private static BufferedReader in; 

6 

7 public static void main(String [] args) 
s d 

9 try 

10 { 


11 // Citeste numarul de figuri 


12 in = new BufferedReader (new 

13 InputStreamReader (System .in )); 

14 System . out. print ("Numarul de figuri: "); 
15 int numShapes = Integer.parselnt( 

16 in.readLine ()); 

17 // citeste formele 

18 Shape [] shapes = new Shape [numShapes |]; 
19 for (int i = 0; i < numShapes; ++i) 

20 

21 shapes[i] = readShape (); 

22 } 

23 

24 // sortare si afisare 

25 insertionSort(shapes); 

26 System.out.println("Sortarea dupa arie: "); 
27 for (int i = 0; i < numShapes; ++i) 

28 { 

29 System . out. println (shapes[i]); 

30 } 

31 } 

32 catch (Exception e) 

33 { 

34 System . out. println (e); 

35 } 

36] 


33 private static Shape readShape() 
3 f 
40 /*x Implementarea in Listing 5.7x*/ 


4l } 
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// sortare prin insertie 
private static void insertionSort(Shape[] a) 


{ 


/x Implementarea in Listing 5.8 */ 


) 


Listing 5.7: Rutină simplă pentru citirea şi returnarea unei noi forme 


//creaza un obiect adecvat de tip Shape functie de 

// datele de intrare. 

// utilizatorul introduce 'c?, 's?' sau ’°r’ pentru a indica 
//forma, apoi introduce dimensiunile 

//in caz de eroare se intoarce un cerc de raza 0 


private static Shape readShape() 
{ 

double rad; 

double len; 

double wid; 


String s; 
try 
{ 
System .out.printin("Introduceti tipul formei: "); 
do 
{ 
s = in.readLine (); 


}while (s.length() == 0); 


switch (s.charAt(0)) 


{ 
case 'c': 
System . out. println ("Raza cercului: "); 
rad = Integer.parselnt(in.readLine ()); 
return new Circle (rad); 
case 's': 
System . out. println ("Latura patratului: "); 
len = Integer.parselnt(in.readLine ()); 
return new Square(len ); 
case 'r': 
System . out. println ("Lungimea si latimea " 
+ " dreptunghiului pe linii separate: "); 
len = Integer.parselnt(in.readLine ()); 
wid = Integer.parselnt(in.readLine ()); 
return new Rectangle (len, wid); 
default: 
System.err.printin("Tastati c, r sau s: "); 
return new Circle (0); 
) 
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42 ) 
43 catch (IOException e) 


“u á { 
45 System . err. println (e); 
46 return new Circle (0); 


47 ) 
a o} 


Listing 5.8: Sortarea prin inserție 


1 // sortare prin insertie 
2 private static void insertionSort(Shape[] a) 


3 { 


4 for (int p = 1; p < a.length; ++p) 

5 { 

6 Shape tmp = afp]; 

7 int j = p; 

8 for( ; j > 0 && tmp.lessThan(a[j-—1]); ——j) 
9 { 

10 a[j] = alj-l]; 

11 } 

12 alj] = tmp; 


5.4  Moştenire multiplă 


Toate exemplele prezentate până acum derivau o clasă dintr-o singură clasă 
de bază. În cazul moştenirii multiple o clasă este derivată din mai mult de o 
clasă de bază. De exemplu, putem avea clasele Student şi Angajat. Din 
aceste clase ar putea fi derivată o clasă AngajatStudent. 


Deşi moştenirea multiplă pare destul de atrăgătoare, iar unele limbaje (cum 
ar fi C++) chiar o implementează, ea este îmbibată de subtilități care fac pro- 
iectarea claselor deosebit de dificilă. De exemplu, cele două clase de bază ar 
putea conţine metode care au aceeaşi semnătură, dar implementări diferite sau 
ar putea avea atribute cu acelaşi nume. Care dintre ele ar trebui folosit? 


Din aceste motive, Java nu permite moştenirea multiplă. Java furnizează 
însă o alternativă pentru moştenirea multiplă prin intermediul conceptului de 
interfaţă. 
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5.5  Interfeţe 


Interfața în Java este cea mai abstractă clasă posibilă. Ea constă doar din 
metode publice abstracte şi din atribute statice şi finale. 

Spunem că o clasă implementează o anumită interfaţă dacă furnizează de- 
finiţii pentru toate metodele abstracte din cadrul interfeţei. O clasă care im- 
plementează o interfață se comportă ca şi când ar fi extins o clasă abstractă 
precizată de către acea interfaţă. 

În principiu, diferenţa esenţială dintre o clasă abstractă şi o interfaţă este 
că, deşi amândouă furnizează o specificaţie a ceea ce clasele derivate trebuie 
să facă, interfaţa nu poate furniza nici un fel de detaliu de implementare sub 
formă de atribute sau de metode implementate. Consecința practică a acestui 
lucru este că derivarea din interfeţe nu suferă de problemele potenţiale pe care 
Je are moştenirea multiplă, deoarece nu putem avea implementări diferite pentru 
aceeaşi metodă. Astfel, deşi o clasă poate să extindă o singură clasă, ea poate 
să implementeze mai mult de o singură interfaţă. 


5.5.1 Definirea unei interfeţe 


Din punct de vedere sintactic, nimic nu este mai simplu decât precizarea 
unei interfeţe. Interfața arată ca o declaraţie a unei clase, doar că foloseşte 
cuvântul cheie interface. Ea constă dintr-o listă de metode care trebuie 
declarate. Un exemplu de interfaţă este Comparable, prezentată în Listing 
5.9. 

Interfața Comparable precizează două metode pe care orice clasă derivată 
din ea trebuie să le implementeze: compareTo () şi lessThan (). Metoda 
compareTo () se va comporta similar cu metoda cu acelaşi nume din clasa 
String. Observaţi că nu este necesar să precizăm faptul că aceste metode sunt 
public sau abstract, deoarece acest lucru este implicit pentru metodele 
unei interfeţe. 


Listing 5.9: Interfața Comparable 


public interface Comparable 
{ 


int compareTo(Comparable rhs); 
boolean lessThan (Comparable rhs); 
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5.5.2 Implementarea unei interfețe 


O clasă implementează o interfață în doi paşi: 
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1. declară că implementează interfaţa; 


2. defineşte implementări pentru toate metodele din interfaţă. 


Un exemplu este prezentat în clasa din Listing 5.10, în care se defineşte clasa 
MyInteger. ClasaMyInteger are un comportament asemănător cu al clasei 
Integer, din pachetul java. Lang. 

În linia 1 se observă că atunci când implementăm o interfaţă folosim cuvân- 
tul cheie implements în loc de extends. În această clasă putem scrie orice 
metode dorim, dar trebuie să definim cel puţin metodele din interfaţă. Interfața 
este implementată în liniile 27-36. Remarcaţi faptul că trebuie să implementăm 
exact metodele precizate în cadrul interfeţei (compareTo, lessThan). Din 
acest motiv aceste metode au ca parametru un obiect de tip Comparable şi nu 
un MyInteger. 

O clasă care implementează o interfaţă poate fi extinsă cu condiţia să nu fie 
finală. Astfel, dacă nu am fi declarat clasa MylIlnteger ca fiind finală, am fi 
putut-o extinde. O clasă care implementează o interfaţă poate totuşi să extindă 
şi o altă clasă. De exemplu, am fi putut, în principiu, scrie: 


public class Mylnteger extends Integer implements Comparable 


Acest cod este incorect doar pentru că Integer este o clasă finală care nu 
poate fi astfel extinsă. 


Listing 5.10: Clasa My Integer care implementează interfaţa Comparable 


ı final public class Mylnteger implements Comparable 


2 { 
// constructor 
public Mylnteger(int value) 


{ 


3 
4 
5 
6 this.value = value ; 
a 
8 
9 


) 


// cateva metode 
0 public String toString() 
u f 


12 return [nteger.toString (value ); 


3] 


5 public int intValue() 
6 4 


17 return value; 


8) 


2 public boolean equals(Object rhs) 
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a f 
22 return rhs instanceof Mylnteger && 
23 value == ((Mylnteger) rhs ). value; 
24) 


2  //implementarea interjfetei 

21 public boolean lessThan (Comparable rhs) 
2 f 

29 return value < ((Mylnteger) rhs ). value ; 
3) 


32 public int compareTo(Comparable rhs) 


33 f 

34 return value < ((Mylnteger) rhs).value ? —1 : 
35 value == ((Mylnteger) rhs).value ? 0 : 1; 
3) 


33 private int value ; 


5.5.3  Interfeţe multiple 


Aşa cum am menționat mai devreme, o clasă poate să implementeze mai 
mult de o singură interfață. Sintaxa pentru a realiza acest lucru este simplă. O 
clasă poate implementa mai multe interfețe prin: 


1. precizarea interfețelor pe care le implementează; 
2. implementarea tuturor metodelor din interfeţe. 


Interfața este cea mai abstractă clasă posibilă şi reprezintă o soluţie elegantă la 
problema moştenirii multiple. 


5.6 Implementarea de componente generice 


Să ne reamintim că unul dintre scopurile principale ale programării orientate 
pe obiecte este suportul pentru reutilizarea codului. Unul dintre mecanismele 
importante folosite pentru îndeplinirea acestui scop este programarea generică: 
dacă implementarea unei metode este identică pentru mai multe clase (cu ex- 
cepţia tipului de bază al obiectului), se poate folosi o implementare generică 
pentru a descrie funcţionalitatea de bază. De exemplu, putem scrie o metodă 
care să sorteze un şir de elemente. Algoritmul pentru această metodă este in- 
dependent de tipul de obiecte care sunt sortate, deci putem folosi un algoritm 
generic. 
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Spre deosebire de multe dintre limbajele de programare mai noi (cum ar 
fi C++) care utilizează şabloane (template) pentru a implementa programarea 
generică, Java nu oferă suport pentru implementarea directă a programării gene- 
rice, deoarece programarea generică poate fi implementată folosind doar con- 
ceptele de bază ale moştenirii. În această secţiune vom prezenta cum pot fi 
implementate metode şi clase generice în Java folosind principiile de bază ale 
moştenirii. 

Ideea de bază în Java este că putem implementa o clasă generică folosind o 
superclasă adecvată, cum ar fi Object. În J ava, dacă o clasă nu extinde o altă 
clasă, atunci ea extinde implicit clasa Object (din pachetul java. Lang). Ca 
o consecinţă, fiecare clasă este o subclasă a lui Object. 

Să considerăm clasa MemoryCell din Listing 5.11. Această clasă poate 
să reţină un obiect de tip Object. Deoarece Object este clasă de bază pen- 
tru orice clasă din Java, rezultă că această clasă poate să stocheze orice fel de 
obiecte. 


Listing 5.11: Clasa generică MemoryCell 
public class MemoryCell 
{ 


private Object storedValue; 


{ 


return storedValue; 


l 
2 
3 
4 
s public Object read () 
6 
7 
3] 

9 


o public void write(Object x) 
uo f 


12 storedValue = x; 


3) 


Există două detalii care trebuie luate în considerare atunci când folosim 
această strategie. Ambele sunt ilustrate în Listing 5.12. Funcţia main () 
scrie valoarea 5 într-un obiect MemoryCell1, după care citeşte din obiectul 
MemoryCell. În primul rând, tipurile primitive nu sunt obiecte. Astfel, 
m.write (5) ar fi fost incorect. Totuşi, aceasta nu este o problemă, deoarece 
Java dispune de clase wrapper (de "împachetare") pentru cele opt tipuri primi- 
tive. În loc să stocăm direct numărul 5, am stocat un obiect de tip Integer cu 
valoarea 5. 

Al doilea detaliu este că rezultatul lui m.read () este un Object. De- 
oarece în clasa Object este definită o metodă toString (), nu este nece- 


sar să facem conversia de la Object la Integer. Referinţa returnată de 
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m.read() (de tip Object) este polimorfică şi ea referă de fapt un obiect 
de tip Integer. În consecinţă, se va apela automat metoda toSstring() a 
clasei Integer. 

Dacă am fi vrut totuşi să extragem valoarea reţinută în obiectul de tip Me- 
moryCell, ar fi trebuit să scriem o linie de genul 


int i = ((Integer) m.read()).intValue); 
în care se converteşte mai întâi valoarea returnată de read la Integer, după 
care se foloseşte metoda intvalue () pentru a obţine un int. 
Deoarece clasele wrapper sunt clase finale, constructorul şi accesorul int- 


Value () pot fi expandate inline? de către compilator, generând astfel un cod 
la fel de eficient ca utilizarea directă a unui int. 


Listing 5.12: Folosirea clasei generice MemoryCell 


public class TestMemoryCell 
{ 


l 

2 

3 public static void main(String [] args) 

a f 

5 MemoryCell m = new MemoryCell (); 

6 

7 m. write (new Mylnteger(5)); 

8 System .out.printin(" Continutul este: " + m.read()); 
9) 


10 } 


Un al doilea exemplu este problema sortării. Anterior am prezentat o metodă 
insertionSort () (Listing 5.8) care lucrează cu un şir de clase Shape. 
Ar fi interesant să rescriem această metodă pentru a putea sorta un şir generic. 
Listing 5.13 prezintă o metodă de sortare generică insertionsort () care 
este practic identică cu metoda de sortare din Listing 5.8 doar că foloseşte 
Comparable în loc de Shape. Putem pune această metodă într-o clasă Sort. 
Observaţi că nu sortăm Object, ci Comparable. Metoda insertion- 
Sort () sortează un şir de elemente Comparable, deoarece foloseşte less- 
Than (). Aceasta înseamnă că doar clasele care implementează interfaţa Com- 
parable pot fi sortate astfel. De remarcat faptul că insertionsort () nu 
poate să sorteze un şir de obiecte Shape, deoarece clasa Shape din Listing 
5.4 nu implementează interfaţa Comparable. Unul dintre exerciţii propune 
modificarea clasei Shape în acest sens. 

Pentru a vedea cum poate fi folosită metoda generică de sortare vom scrie 
un program, prezentat în Listing 5.14, care citeşte un număr nelimitat de va- 


3Deşi anumiţi termeni (de exemplu, wrapper, inline) sunt în limba engleză, am optat pentru 
păstrarea lor în formă originală, deoarece aşa s-au consacrat în literatura de specialitate. Considerăm 
că traducerea în limba română ar fi inoportună, deteriorând semnificaţia lor. 
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lori întregi, le sortează şi afişează rezultatul. Metoda readIntArray () a 
clasei Reader (prezentată în capitolul precedent) este folosită pentru a citi 
un şir de numere întregi. Transformăm apoi şirul citit într-un şir de elemente 
MyInteger, care implementează interfaţa Comparable. În linia 15 creăm 
şirul, iar în liniile 16-19 obiectele care sunt stocate în şir. Sortarea este realizată 
în linia 22. În final, afişăm rezultatele în liniile 26-29. De reţinut că metoda 
toString () este implicit apelată pentru clasa MyInteger. 


Listing 5.13: Algoritm de sortare generic 


1 // sortare prin insertie 
2 public static void insertionSort(Comparable [|] a) 


34 

4 for(int p = l1; p < a.length; ++p) 

5 { 

6 Comparable tmp = af[p]; 

7 int j = p; 

8 for( ; j >0 && tmp.lessThan (a[j—1]); ——j) 
9 { 

10 a[j] = a[j—1]; 

LI } 

12 alj] = tmp; 


Listing 5.14: Citirea unui şir de numere întregi şi ordonarea lui folosind un 
algoritm generic 


ı import io.*; //pachet definit anterior 
2 public class Sortlns 


3 { 


4 //program de test care citeste numere intregi 

5s //(cate unul pe linie), le ordoneaza si apoi le afiseaza 
6 

7 public static void main(String [] args) 

s d 

9 

10 // citeste un sir de intregi 

11 System . out. print ("Elementele sirului: "); 

12 int [] sir = Reader .readIntArray (); 

13 

14 // conversie la un sir de Mylnteger 

15 Mylnteger[] sirNou = new MyInteger[sir.length ]; 
16 for (int i = 0; i < sir.length; ++i) 

17 { 

18 sirNou[i] = new Mylnteger(sir[i]); 

19 } 

20 

21 // aplica metoda de sortare 
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22 Sort.insertionSort(sirNou); 
23 
24 //afiseaza rezultatul sortarii 
25 System .out.printin("Rezultatul sortarii: "); 
26 for(int i = 0; i < sirNou.length; ++i) 
27 í 
28 System . out. println (sirNou[i]); 
29 
) 


5.7 Clase interioare (inner classes) 


Clasele interioare reprezintă un tip special de clase care, după cum le spune 
şi numele, sunt definite în interiorul altor clase. Clasele care includ clase inte- 
rioare se numesc (evident) clase exterioare. Clasele interioare sunt o facilitate 
importantă a limbajului Java, deoarece ne permit să grupăm clasele care aparţin 
în mod logic una de celalaltă şi să controlăm nivelul de vizibilitate între aceste 
clase. Clasele interioare reprezintă un concept distinct de compoziţia claselor (o 
clasă are un atribut de tipul altei clase). Diferenţele le veţi înţelege aprofundând 
treptat noţiunea de clasă interioară. 

Necesitatea claselor interioare nu este deloc evidentă (cinstit vorbind, câţi 
dintre programatorii de Java care citesc această lucrare au auzit sau au folosit 
clase interioare?). Sperăm ca exemplul din această carte să clarifice utilitatea 
lor. 

Aşa cum era de aşteptat, o clasă interioară se defineşte în cadrul altei clase 
care o cuprinde: 


1 /** 

2 * Clasa exterioara. 

3 */ 

4 public class Scrisoare 


5 

{ 

6 class Destinatie 
7 { 

8 

9 } 


LI //alte posibile clase interioare 


14 //atribute si metode ale clasei exterioare 
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In exemplul de mai sus clasa exterioară este Scrisoare, iar cea interioară 
este Destinatie. Pentru a face acest exemplu funcţional, creaţi fişierul sursă 
Scrisoare. java ca în Listing 5.15. 


Listing 5.15: Clasa Scrisoare care cuprinde clasa interioară Destinatie 


1 /** 

2x Clasa exterioara Scrisoare 

3 */ 

4 public class Scrisoare 

s | 

6 /** 

7 x Clasa interioara Destinatie. 

8 */ 

9 class Destinatie 

0 | 

11 /xx Destinatia unei scrisori.x/ 
12 private String dest; 

13 

14 

15 /*xx* Creaza o destinatie pentru scrisoare. x*/ 
16 Destinatie (String dest) 

17 { 

18 this.dest = dest; 

19 } 

20 

21 /xx Obtine destinatia scrisorii.+*/ 
22 public String obtineDestinatia() 
23 { 

24 return dest; 

25 } 

26) 


28 /x» Trimite scrisoare la adresa specificata.x*/ 
22 public void trimiteScrisoare (String dest) 


30 

{ 
31 Destinatie d = new Destinatie (dest ); 
32 
33 System . out. println ("Scrisoarea a fost trimisa " + 
34 "la destinatia: " + d.obtineDestinatia ()); 
35 

} 


373 /xx* Programul principal.x/ 
33 public static void main(String [] args) 


3 f 

40 // creaza o scrisoare 

4l Scrisoare s = new Scrisoare (); 
42 

43 // trimite scrisoarea in "SUA" 
44 s.trimiteScrisoare ("SUA"); 
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45 } 
46 ) 


Prin rularea acestui exemplu se va obține următorul rezultat: 
Scrisoarea a fost trimisa la destinatia: SUA 


Dacă priviți cu atenție rezultatul compilării fişierului Scrisoare. java, 
veţi observa apariţia a două fişiere: Scrisoare.classşi Scrisoare$Des- 
tinatie.class. Cum rezultatul compilării fiecărei clase este un fişier cu 
extensia .class, care conţine bytecode-ul pentru clasa respectivă, este normal 
ca şi o clasă interioară să producă un fişier .class, care să conţină bytecode-ul 
produs de compilator. Pentru a face sesizabilă legătura dintre clasa exterioară 
şi cea interioară chiar şi în situaţia în care fişierele sursă ale claselor nu sunt 
disponibile, creatorii limbajului Java au ales ca fiecare clasă interioară să res- 
pecte o formulă strictă în ceea ce priveşte numele fişierului .class care îi 
corespunde. Această formulă arată astfel: 


NumeClasaExterioara$NumeClasalnterioara 


În exemplul nostru, clasa interioară Destinatie, care este utilizată în 
metoda trimiteScrisoare (), arată ca orice altă clasă. Singura diferenţă 
pare a fi faptul că este definită în interiorul altei clase. Vom vedea mai târziu că 
există şi alte diferenţe mai subtile. 

În exemplul anterior clasa interioară Destinatie nu a fost utilizată în 
mod direct în programul principal, dar nimic nu ne împiedică să o utilizăm. 
Utilizarea în metoda main a clasei interioare se realizează astfel: 


ı public static void main(String [] args) 


2 | 
//creaza o scrisoare 
Scrisoare s = new Scrisoare); 


3 
4 

5 

6 // trimite scrisoarea in "SUA" 
7 s.trimiteScrisoare ("SUA"); 

8 
9 


// creaza o alta destinatie 
10 Destinatie d = s.new Destinatie("Canada"); 


Sintaxa pentru crearea unei clase interioare este neobişnuită şi poate pune 
în încurcătură chiar şi programatorii care au ceva experienţă în Java. După cum 
se poate observa, pentru a crea direct o instanţă a clasei interioare (în exemplul 
nostru, d), este necesară utilizarea unei instanțe a clasei exterioare (în exemplul 
nostru, s). Astfel, nu este posibilă crearea unei instanţe a clasei interioare, 
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dacă nu este deja creată o instanţă a clasei exterioare. Limbajul Java impune 
o astfel de strategie, deoarece obiectul interior (cu alte cuvinte, instanţa clasei 
interioare) este conectat la obiectul exterior (instanţa clasei exterioare) din care 
este creat. Această conexiune este specifică doar claselor interioare şi va fi 
detaliată în cadrul acestui capitol. 

Construcţia inestetică de instanţiere a clasei interioare poate fi totuşi evi- 
tată utilizând un mic artificiu. Vom adăuga în clasa exterioară Scrisoare o 
metodă catre care creează un obiect de tip destinaţie: 


P i 
2 

3/xx Stabileste destinatia unei scrisori.x*/ 
4 public Destinatie catre(String dest) 


5s { 


6 return new Destinatie(dest); 

7) 

8 

9 

10 

u public static void main(String |] args) 


12 f 


15 Destinatie d = s.catre("Canada"); 


O clasă interioară poate fi accesată uneori şi de alte clase, nu numai de către 
clasa exterioară care o conţine. Pentru a defini o astfel de referinţă a clasei inte- 
rioare Destinatie, este necesar ca tipul referinţă asociat să conţină şi numele 
clasei exterioare, în formatul ClasaExterioara.Clasalnterioara. Pen- 
tru exemplul nostru declararea ar arăta astfel: 


Scrisoare. Destinatie d; 


Dacă necesitatea de a utiliza clasa interioară în cadrul altei clase apare prea 
frecvent, este un semn că am proiectat greşit aplicaţia, şi că, probabil, clasa 
respectivă nu este cazul să fie interioară. 

Să revenim pentru moment asupra conexiunii care se realizează între clasa 
interioară şi cea exterioară. În momentul în care se crează o instanţă a clasei 
interioare, se crează o legătură între clasa interioară respectivă şi instanţa clasei 
exterioare, care conţine această clasă interioară. Acest lucru permite ca membrii 
clasei exterioare să fie accesibili clasei interioare, fără a folosi vreo calificare 
specială. De exemplu, putem modifica exemplul anterior, introducând un nou 
atribut pentru clasa exterioară, care va fi accesat în clasa interioară: 


ı public class Scrisoare 
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2 | 

3 

4 

5 /x* * 

6 x Pentru a verifica daca scrisoarea a fost trimisa 
7 x la destinatie. 

8 x / 

9 boolean trimisa; 

10 

1 

12 

13 class Destinatie 

14 í 

15 

16 

17 Destinatie (String dest) 
18 { 

19 this.dest = dest; 
20 

21 // initial scrisoarea nu a fost trimisa 
22 trimisa = false; 

23 } 

24 

25 

26 } 

27 } 


După cum se poate observa, atributul trimisa al clasei exterioare a fost 
utilizat în clasa interioară, fără nici o calificare specială, ca şi cum ar fi fost 
un atribut al acesteia. Explicația este următoarea: clasa interioară păstrează 
referința clasei exterioare, responsabilă de crearea instanței clasei interioare (în 
exemplul nostru, această referință este s). Când un membru al clasei exterioare 
este utilizat în cadrul clasei interioare, referința aceasta (ascunsă) este folosită 
pentru a accesa acel membru. Din fericire pentru noi, compilatorul este cel care 
tine cont de toate aceste detalii. Ca urmare, compilatorul va considera drept 
eroare situația în care nu va putea accesa referința clasei exterioare. 

O altă caracteristică specifică doar claselor interioare este că ele pot fi as- 
cunse complet de orice clasă, indiferent de pachetul în care se află. Spre deose- 
bire de acest caz, mecanismul standard de ascundere a claselor permite doar ca 
o clasă să fie definită "prietenoasă" (friendly), ceea ce presupune că ea este to- 
tuşi accesibilă claselor din acelaşi pachet. Aşadar, dacă doriți ca implementarea 
unei clase să fie complet ascunsă celorlalte clase, indiferent de pachetul în care 
se află, puteţi implementa clasa ca fiind interioară. Aşa cum era de aşteptat 
ascunderea unei clase interioare se face prin declararea ei ca fiind private: 


ı private class Destinatie 


2 { 
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3 


4) 


In acest moment, clasa Destinatie este inutilizabilă pentru orice altă 
clasă cu excepţia clasei Scrisoare în care a fost definită. Pentru a verifica 
acest lucru, să mai adăugăm o clasă în fişierul Scrisoare. java: 


ı public class Scrisoare 


2 { 


3 
4) 

5 

6/*xx* Clasa de test pentru clasa interioara privata.x*/ 
7 class Test() 


s { 


9 public static void main(String [|] args) 


10 { 
g) Scrisoare. Destinatie d; //EROARE DE COMPILARE 


Încercarea de a compila acest program este sortită eşecului, deoarece clasa 
interioară Destinatie reprezintă un membru privat al clasei Scrisoare şi 
nu poate fi accesat în afara clasei al cărei atribut este. Compilatorul va afişa o 
eroare de genul: 


Scrisoare.java:59: Scrisoare.Destinatie has private 
access in Scrisoare 
Scrisoare.Destinatie d; 


AN 


1 error 


Deoarece clasa interioară este declarată ca fiind private, nici o clasă, cu 
excepţia clasei exterioare Scrisoare, nu o poate accesa. Cu alte cuvinte uti- 
lizarea clasei interioare este restricţionată total în afara clasei exterioare. Astfel, 
clasele interioare oferă o modalitate de a preveni orice dependenţă de alte clase, 
dar şi de a ascunde complet detaliile de implementare. 

Analog o clasă interioară poate fi declarată ca fiind protected, ceea ce 
înseamnă că doar clasa exterioară şi clasele care o derivează pot accesa clasa 
interioară respectivă. 

Un aspect important care trebuie reţinut este următorul: clasele normale 
(care nu sunt interioare) nu pot fi declarate private sau protected, ci doar 
public sau friendly (fără modificator de acces). De altfel, nici nu ar avea sens 
o clasă ne-interioară declarată în acel mod, deoarece nu am putea defini faţă de 
cine este private sau protected. 
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5.7.1 Clasificarea claselor interioare 


În general, clasele interioare pe care le veţi folosi în programele dumnea- 
voastră vor fi clase simple, uşor de înţeles şi utilizat, asemănătoare cu cele cre- 
ate în exemplele anterioare. Totuşi, limbajul Java oferă şi alte tipuri de clase 
interioare, ceva mai complexe. 

În total, limbajul Java oferă patru tipuri de clase interioare: 


e clase membre statice ale clasei exterioare 


Ca orice metodă statică a unei clase, o clasă membru static are acces la 
toate metodele şi atributele statice ale clasei părinte (cu alte cuvinte, ale 
clasei exterioare); 


e clase membre nestatice ale clasei exterioare 


Spre deosebire de clasele membre statice, cele nestatice au acces la toate 
metodele şi atributele clasei exterioare, inclusiv la referinţa thi s a aces- 
teia. Clasele interioare utilizate în exemplele precendente sunt de acest 
tip; 

e clase locale 


Clasele locale sunt definite în cadrul unui bloc de cod, fiind vizibile doar 
în cadrul acelui bloc, similar cu o variabilă locală definită în cadrul unei 
metode; 


e clase anonime 


Clasele anonime sunt clase locale fără nume. 


5.7.2 Clasele membre statice ale clasei exterioare 


Conexiunea dintre referinţa clasei exterioare şi cea a clasei interioare poate 
fi eliminată în situaţia în care clasa interioară este declarată statică. In cazul 
unei clase interioare statice: 


e nu este necesară o instanţă a clasei exterioare pentru a crea o instanţă a 
clasei interioare; 


e pot exista membri statici în clasa interioară respectivă. 


Putem modifica exemplul nostru, pentru a utiliza clase interioare statice. Iată 
cum arată fişierul sursă Scrisoare. java în această situaţie: 
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I /** 


Listing 5.16: Exemplu utilizare clase interioare statice 


2 x» Clasa exterioara Scrisoare 


3 */ 


4 public class Scrisoare 


5s { 


/* x 

x» Clasa interioara Destinatie. 
*/ 

private static class Destinatie 
{ 


/xx Destinatia unei SCrisori.x*/ 
private String dest; 


/*xx* Creaza o destinatie pentru scrisoare. x/ 
Destinatie( String dest) 


{ 


this.dest = dest; 


/xx Obtine destinatia scrisorii.*/ 
public String obtineDestinatia() 


{ 


return dest; 


/x» Exemplu de membru static al clasei statice.x/ 
public static void f() 


{ 
} 
} 
public static Destinatie catre(String dest) 
{ 
return new Destinatie (dest ); 
} 


/x* Trimite scrisoare la adresa specificata. +*/ 
public static void trimiteScrisoare(Destinatie d) 
{ 
System. out. println ("Scrisoarea a fost trimisa" + 
" la destinatia: " + d.obtineDestinatia()); 


) 


/xx Programul principal. */ 
public static void main(String |] args) 


{ 


Destinatie d = catre("Canada"); 
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50 // trimite scrisoarea la destinatie 
51 trimiteScrisoare(d); 


Folosind clase statice interioare, nu a mai fost necesară crearea unei instanțe 
a clasei exterioare Scrisoare. După rularea programului se va afişa urmă- 
torul rezultat: 


Scrisoarea a fost trimisa la destinatia: Canada 


5.7.3 Clasele membre nestatice ale clasei exterioare 


Clasele membre nestatice au fost prezentate pe larg la începutul acestui sub- 
capitol, motiv pentru care au mai rămas puține detalii de adăugat: 


e spre deosebire de clasele interioare statice, cele nestatice nu pot avea 
membri statici; 


e uneori este necesară referința clasei exterioare, care este obținută folosind 
sintaxa NumeClasaExterioara.this. [In exemplul nostru, referin- 
ţa la clasa exterioară se obține prin Scrisoare.this. 


5.7.4 Clase locale 


O clasă locală poate fi creată în cadrul unei metode, ca în exemplul următor: 


Listing 5.17: Exemplu utilizare clase locale 


1 /** 

2 * Clasa exterioara Scrisoare 
3 */ 

4 public class Scrisoare 


s { 


6 /xx Metoda ce cuprinde o clasa interioara */ 
7 public String catre(String dest) 

8 { 

9 /* * 

10 x Clasa interioara Destinatie. 

g! */ 

12 class Destinatie 

13 { 

14 /x*x Destinatia unei scrisori.*/ 

15 private String dest; 
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18 /xx* Creaza o destinatie pentru scrisoare.x*/ 
19 Destinatie (String dest) 

20 í 

21 this .dest = dest; 

22 ) 

23 

24 /xx* Obtine destinatia scrisorii.*/ 

25 public String obtineDestinatia() 

26 

27 return dest; 

28 ) 

29 ) 

30 

31 return (new Destinatie(dest )). obtineDestinatia (); 
32 ) 

33 

34 /xx Trimite scrisoare la adresa specificata.+/ 
35 public void trimiteScrisoare (String dest) 

36 { 

37 System . out. println ("Scrisoarea a fost trimisa" + 
38 " la destinatia: " + catre(dest)); 
39 } 

40 

4l /xx Programul principal. */ 

42 public static void main(String [|] args) 

43 { 

44 Scrisoare s = new Scrisoare); 

45 

46 //trimite scrisoarea la destinatie 

47 s.trimiteScrisoare ("Romania"); 

48 

49 } 

50 } 


Este evident faptul că aplicația nu are o utilitate practică, din moment ce 
afişează chiar stringul pe care îl primeşte ca parametru. Ea reprezintă doar un 
pretext pentru a vedea cum se crează o clasă interioară locală. Este uşor de ob- 
servat că metoda catre cuprinde clasa interioară Destinatie în interiorul 
ei. Fiind definită în această metodă, clasa Destinatie este accesibilă doar în 
cadrul metodei. Încercarea de a o utiliza în afara metodei respective produce o 
eroare la compilarea programului. 

Prin rularea programului se obţine următorul rezultat: 


Scrisoarea a fost trimisa la destinatia: Romania 


Pentru a complica şi mai mult lucrurile, trebuie să adăugăm că o clasă in- 
terioară poate fi definită şi în cadrul unui bloc de instrucţiuni, asemănător cu 
exemplul anterior, în care metoda catre este modificată astfel: 
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ı public String catre(String dest) 


2 

{ 

3 if (dest != null) 

4 { 

5 [x x 

6 x Clasa interioara Destinatie. 

7 */ 

8 class Destinatie 

9 { 

10 /*xx*x Destinatia unei scrisori.*/ 
LI private String dest; 

12 

13 

14 /xx Creaza o destinatie pentru scrisoare. */ 
15 Destinatie( String dest) 

16 { 

17 this.dest = dest; 

18 ) 

19 

20 /xx Obtine destinatia scrisorii.x/ 
21 public String obtineDestinatia() 
22 { 

23 return dest; 

24 } 

25 } 

26 

27 return (new Destinatie(dest)). obtineDestinatia (); 
28 } 

29 else 

30 { 

31 return null; 

32 ) 

33 ] 


Deşi această utilizare pare destul de curioasă, clasa interioară Destina- 
tie poate fi definită în cadrul unui bloc de instrucţiuni (în cazul nostru, in- 
strucţiunea if), fiind vizibilă doar în acel bloc. Pentru a risipi eventuale urme 
de îndoială este util de reţinut că definirea clasei Destinatie în cadrul in- 
strucțiunii i f, nu înseamnă că această clasă este creată în funcţie de îndeplinirea 
condiţiei din if. Clasa va fi creată ca orice altă clasă la compilarea programu- 
lui, dar nu va putea fi utilizată decât în cadrul blocului de instrucţiuni în care a 
fost definită. 


Clasele locale sunt foarte rar utilizate din cauza codului mai puţin lizibil pe 
care îl crează (noi nu le vom utiliza deloc în cadrul acestei lucrări). Totuşi ele 
există şi pot fi utilizate în situaţii în care programatorul consideră că este nevoie 
de ele. 
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5.7.5 Clase anonime 


Dacă exemplele anterioare v-au creat impresia că noţiunea de clasă locală 
este mai "deosebită", pregătiţi-vă să vă întăriţi această convingere, urmărind cu 
atenţie modul de definire al claselor anonime. Pentru o mai bună înţelegere, iată 
un exemplu ce defineşte o clasă anonimă: 


Listing 5.18: Model de definire a unei clase anonime 


1 /x* x 

2 * Clasa exterioara Scrisoare 

3 */ 

4 public class Scrisoare 

s| 

6 public Destinatie trimite () 

7 { 

8 return new Destinatie (9) 

9 { 

10 private String dest2; 

LI 

12 public String obtineDestinatia() 
13 { 

14 return "Germania"; 

15 } 

16 ); //";" este necesar la definirea claselor anonime 
17 } 

18 

19 /xx Programul principal. */ 

20 public static void main(String [] args) 
21 { 

22 Scrisoare s = new Scrisoare); 

23 

24 Destinatie d = s.trimite(); 

25 } 

26 } 


2 class Destinatie 
29 | 
30 private String dest; 


31} 


Analizând exemplul întâlnim două clase, Scrisoare şi Destinatie, 
şi o modalitate mai puțin întâlnită de definire a metodei trimite. Această 
metodă combină procesul de returnare a unei instanțe a clasei Destinatie, 
la linia 8, cu cel de definire a unei clase fără nume (anonimă), la liniile 9-16. 
Clasa anonimă reprezintă o subclasă a clasei Destinatie, datorită faptului că 
definirea clasei apare imediat după numele clasei Destinatie. În consecință 
mai apare o clasă, despre care nu putem spune ce nume are, ci doar că extinde 
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clasa Destinatie. 
Definirea metodei trimite poate fi analizată în două părţi: 


e crearea şi returnarea unei instanţe a clasei Destinatie: 


return new Destinatie () 


e definirea clasei anonime: 


private String dest2; 


public String obtineDestinatia() 


{ 


return "Germania"; 


Această construcție trebuie privită ca o modalitate de a defini o clasă care de- 
rivează clasa Destinatie, fără a mai specifica numele acestei clase. Mai 
precis, clasa anonimă este prescurtarea codului următor: 


ı class DestinatiaMea extends Destinatia 


2 

{ 

3 private String dest2; 

4 

5 public String obtineDestinatia() 
6 { 

7 return "Germania"; 

8 } 

9} 


10 
u return new DestinatiaMea (); 


Una dintre cele mai importante caracteristici ale claselor interioare anonime 
este aceea că nu pot avea constructori expliciți. Este evidentă această concluzie 
din moment ce o astfel de clasă nu are un nume. 

Clasa de bază Destinatie este însă o clasă exterioară (deci, neanonimă), 
care poate avea constructori de orice tip. Apelul unui constructor neimplicit (cu 
parametri) se poate realiza astfel: 


ı public class Scrisoare 


{ 


public Destinatie trimite(String destinatie) 


{ 


/*xx Utilizarea constructorului explicit. x*/ 
return new Destinatie(destinatie) 


{ 


© >% A A o àA v N 
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10 private String dest2; 
l1 

12 public String obtineDestinatia() 
13 { 

14 return ""; 

15 } 

16 y: 

17 ) 

18 

19 

20 } 


2 class Destinatie 


23 

{ 

24 private String dest; 

25 

26 Destinatie (String dest) 
27 { 

28 this.dest = dest; 
29 } 

30 } 


Nici un exemplu de utilizare a claselor anonime, dintre cele prezentate până 
în acest moment, nu poate să execute operații de inițializare asupra atributelor 
clasei anonime, pentru a simula funcționalitatea unui constructor explicit. Pen- 
tru a realiza acest lucru este necesar ca parametrul cu care va fi inițializat atribu- 
tul în cauză să fie declarat final, ca în exemplul: 


i //argumentul este declarat final. 
2 public Destinatie trimite(final String destinatie) 


3 

{ 

4 return new Destinatie () 

5 { 

6 private String dest2 = destinatie; 
A 

8 public String obtineDestinatia() 
9 { 

10 return dest2; 


12 je 


Aşa cum aţi putut constata deja, clasele anonime crează un cod mai puţin 
lizibil, motiv pentru care este indicat ca folosirea lor să fie limitată la acele clase 
care sunt foarte mici ca dimensiune (o metodă sau două) şi care au o utilizare 
foarte uşor de înţeles. Veţi fi probabil surprinşi să aflaţi că probabil cel mai des 
utilizate clase interioare în practică sunt cele anonime. Clasele anonime sunt 
preferate de programatori când este vorba de a defini clase simple derivate din 
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Thread (vezi capitolul 8), clase de tip Listener (utilizate foarte frecvent în 
AWT şi Swing) sau alte clase având o singură metodă, deoarece codul clasei 
apare exact în locul în care este folosit, uşurând astfel înţelegerea programului. 
Clasele anonime mai au şi avantajul că se pot aduce mici modificări claselor 
existente fără a încărca inutil aplicaţia cu o arborescenţă inutilă de clase triviale. 


5.7.6 Avantajele şi dezavantajele claselor interioare 
Avantajele utilizării claselor interioare 


Deşi par incomode la prima vedere, clasele interioare nu reprezintă doar 
un simplu mecanism de "ascundere" a codului, prin plasarea unor clase în in- 
teriorul altor clase. Clasele interioare sunt capabile de mai mult, pentru că au 
posibilitatea de comunicare cu clasa exterioară. 

În principiu, clasele interioare oferă următoarele tipuri de avantaje: 


e avantajul orientării pe obiecte 


Folosind clasele interioare codul devine chiar mai orientat pe obiecte, 
decât în lipsa lor, deoarece ele permit "eliminarea" anumitor părţi de 
cod din cadrul unei clase (clasa exterioară) şi introducerea lor într-o 
clasă proprie (clasa interioară). Altfel spus, din punct de vedere al ori- 
entării pe obiecte, funcţionalitatea care nu aparţine de clasa exterioară 
este înlăturată şi plasată într-o clasă interioară, rezultând astfel o decu- 
plare a funcţionalităţilor clasei exterioare şi un cod mult mai elegant şi 
mai clar. Mai mult, clasa interioară poate avea în continuare acces la 
toate atributele şi metodele clasei exterioare, în cazul în care este mem- 
bru nestatic al clasei exterioare; 


e avantajul organizării claselor 


Clasele interioare permit o organizare mai bună a structurii pachetelor. 
Astfel, clasele care nu trebuie să fie accesibile altor clase, chiar şi celor 
din acelaşi pachet, pot fi definite ca fiind clase interioare, în aşa fel încât 
să fie accesate doar de clasa exterioară care le conţine. 


Dezavantajele utilizării claselor interioare 


Clasele interioare prezintă dezavantaje ce nu trebuie neglijate. Din punctul 
de vedere al întreţinerii aplicaţiilor, programatorii Java neexperimentați pot con- 
sidera clasele interioare foarte dificil de înţeles. Este o reacţie normală deoarece 
este necesară o perioadă de timp pentru ca programatorii Java să se obişnuiască 
cu acest concept şi să considere utilă folosirea lui. Un alt dezavantaj ce merită a 
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fi semnalat este că utilizarea claselor interioare produce o creştere a numărului 
de clase ale aplicaţiei. 


Concluzii 


Clasele interioare reprezintă un concept sofisticat care este întâlnit în mai 
multe limbaje de programare obiect-orientate. Nivelul de complexitate mai ridi- 
cat decât al altor concepte ale limbajului Java, face ca acest tip de clase să fie 
mai puţin preferat de programatorii începători. Cu timpul însă, ei acumulează 
experienţa necesară pentru a recunoaşte situaţiile în care se impune utilizarea 
claselor interioare. Din acest motiv, pentru cei aflaţi în faza de iniţiere în lim- 
bajul Java este suficient dacă reuşesc să se familiarizeze cu sintaxa şi modul lor 
de utilizare. 


5.8 Identificarea tipurilor de date în faza de exe- 
cuţie 


Pentru fiecare obiect existent în cadrul unei aplicaţii, limbajul Java oferă 
posibilitatea de a afla informaţii cu privire la clasa a cărei instanţă este acel 
obiect. Aceste informaţii pot fi colectate în faza de execuţie a aplicaţiei respec- 
tive ("runtime"). 

Pentru a vă convinge că astfel de informații sunt necesare, vom considera 
un exemplu, care va arăta în mod explicit de ce uneori este nevoie să cunoaştem 
tipul de date al unui obiect în faza de execuţie a programului. Să presupunem 
că avem clasa de bază Masina, din care se derivează alte clase, câte una pen- 
tru fiecare tip de maşină. Astfel, avem clasele Dacia, Opel, Ferrari, etc. 
Să presupunem că toate maşinile au un preţ, şi că pentru fiecare maşină ex- 
istă un mod diferit de a-i calcula costul. În J ava, aceasta înseamnă că metoda 
afiseazaPret () este o metodă abstractă a clasei de bază Masina, care 
are câte o implementare diferită pentru fiecare dintre clasele Dacia, Opel, 
Ferrari. 


Listing 5.19: Clasa abstractă Masina şi clasele derivate din ea 


1 // Continutul fisierului Identificare . java 
2 import java.util.x; 
3 
4 abstract class Masina 
5 
{ 


6 abstract void afiseazaPret(); 
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o class Dacia extends Masina 


10 { 


u void afiseazaPret() 


2 f 
13 System . out. println("Pretul unei Dacii este de " + 
14 "5.000 de dolari."); 


5) 
16 ) 


is class Opel extends Masina 


19 

{ 

2 void afiseazaPret() 

2 f 

22 System . out. println("Pretul unui Opel este de " + 
23 "15.000 de dolari."); 

24 } 

25 } 


= class Ferrari extends Masina 

28 | 

2 void afiseazaPret() 

30 { 

31 System .out.printin("Pretul unui Ferrari este de " + 
32 "75.000 de dolari."); 


35 
3s public class Identificare 


37 
{ 
33 public static void main(String [] args) 
39 
{ 
40 Vector v = new Vector (); 
4l 
42 v.add(new Dacia ()); 
43 v.add(new Opel ()); 
44 v.add(new Ferrari ()); 
45 
46 for(int i =0; i < v.size(); i++) 
47 { 
48 ((Masina) v.elementAt(i )). afiseazaPret(); 
49 } 
5] 


După cum reiese din Listing 5.19, fiecare clasă care extinde clasa de bază 
Masina are propria ei definire a metodei afiseazaPret (). Metodamain () 
a programului principal crează un vector de elemente, în care se stochează câte 
un obiect, instanţă a unei clase derivate din clasa de bază Masina. Deoarece 
clasa Vector stochează doar instanţe ale clasei Object, fiecare dintre in- 
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stanţele anterioare va fi stocată ca un obiect de tip Object, pierzându-se (aparent) 
informaţia specifică tipului a cărei instanţă este de fapt. În final, vectorul este 
parcurs şi pentru fiecare element al său este apelată metoda afiseazaPret (). 
Operația de cast (conversia explicită la tipul Masina) este necesară pentru 
a putea apela metoda afiseazaPret (), care nu există în clasa Object, 
redând astfel o parte din funcţionalitatea obiectelor. Funcţionalitatea specifică 
nu este redată în totalitate deoarece în acest moment se cunoaşte doar faptul că 
vectorul conţine instanţe ale claselor derivate din clasa Masina, fără a cunoaşte 
exact aceste clase (Dacia, Opel, etc.). Totuşi, după cum am văzut în paragra- 
ful 5.2.3, apelul metodei afiseazaPret () pe un obiect convertit la clasa 
Masina, va conduce prin polimorfism la apelul metodei cu acelaşi nume din 
clasa care a fost utilizată la crearea instanţei (Dacia, Opel, sau Ferrari), 
obținându-se următorul rezultat: 


Pretul unei Dacii este de 5.000 de dolari. 
Pretul unui Opel este de 15.000 de dolari. 
Pretul unui Ferrari este de 75.000 de dolari. 


Astfel, folosind polimorfismul se pot crea instanţe ale unor clase speci- 
fice (Dacia, Opel, Ferrari), care sunt convertite apoi la o clasă de bază 
(Masina), ceea ce implică pierderea tipului specific al obiectului, după care, 
pe parcursul programului, se pot utiliza aceste referinţe către clasa de bază. 
Efectul este că metoda exactă care va fi apelată pentru un obiect convertit la 
clasa Masina este determinată de referinţă, care poate fi către una din clasele: 
Dacia, 0pel,Ferrari. 

În general, exact acest lucru se urmăreşte: ca secvențele de cod să deţină 
cât mai puţine informaţii despre tipul specific al unui obiect şi să utilizeze doar 
reprezentarea generală a unei familii de obiecte (în cazul nostru, maşini). Ceea 
ce rezultă este un cod sursă mult mai uşor de scris, citit, înţeles şi modificat. 
Este motivul pentru care polimorfismul este unul dintre principiile esenţiale ale 
programării orientate pe obiecte (şi totuşi, atât de neglijate de începători). 

Există însă situaţii în care este utilă chiar cunoaşterea exactă a tipului unui 
obiect. De exemplu, dacă doriţi să specificaţi că o maşină Ferrari este disponi- 
bilă doar în culoarea roşie, este necesar să testăm obiectul respectiv, pentru a 
vedea ce clasă instanţiază. 


În Java există două metode de a afla tipul de date al unui obiect: 


e identificarea standard a tipului de date, ce presupune că toate tipurile de 
date sunt disponibile atât în faza de compilare cât şi în cea de execuţie a 
aplicaţiei; 
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e mecanismul de reflecţie, care descoperă informaţii despre o clasă doar în 
timpul fazei de execuţie. 


5.8.1 Identificarea standard a tipurilor de date 


În Java, identificarea standard a tipurilor de date se poate realiza în trei 
moduri: 


e Utilizând operatorul de cast (în exemplul anterior acesta a fost utilizat 
la conversia către clasa Masina). Dacă operaţia de cast este incorectă 
(dacă obiectul nu poate fi covertit la tipul specificat), atunci va fi aruncată 
o excepţie de tipul ClassCastException; 


e Utilizând un obiect de tip Class, care conţine informaţii despre clasa 
respectivă. Uneori clasa Class mai este denumită şi metaclasă. Maşina 
virtuală Java ataşează fiecărei clase existente într-un program un obiect 
de tipul Class, care este utilizat pentru a crea instanţe ale clasei respec- 
tive, dar care poate fi utilizat şi de programator pentru a afla date despre 
asociat unei clase (pentru exemplificare am ales clasa Identificare 
din programul anterior): 


— folosind metoda forName a clasei Class: 


ı Class c = null; 
2 try 
34 


4 c = Class .forName ("Identificare"); 


5} 


6 catch (ClassNotFoundException cnfe) 
7 { 
8} 


— folosind atributul .class asociat oricărei clase: 


Class c = Identificare. class ; 


În general se preferă utilizarea celei de-a doua modalităţi, din mai multe 
motive. În primul rând este mai simplă, deoarece nu necesită prinderea şi 
tratarea excepţiei ClassNotFoundException. În al doilea rând este 
mai sigură, deoarece existenţa clasei Identificare este verificată în 
faza de compilare şi nu în cea de execuţie, ca în primul caz. 
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Obiectul de tip Class asociat unei clase poate fi obţinut şi cu ajutorul 
unei instanţe a clasei respective, utilizând metoda getClass () a clasei 
Object: 


Masina m = new Dacia); 
Class c = m. getClass (); 


e Utilizând cuvântul cheie instanceof, care verifică dacă un obiect este 
instanță a unei clase specificate şi returnează o valoare booleană. Iată un 
exemplu de utilizare în contextul aplicației anterioare: 


ı Masina m = new Dacia); 


2 
3if (m instanceof Dacia) 


al 


5 System . out. println ("Masina aceasta este o Dacie."); 
5) 

7 else 

8 { 

9 System . out. println ("Masina aceasta NU este o Dacie."); 


10 } 


Rezultatul execuției acestei secvențe este: 
Masina aceasta este o Dacie. 


Limbajul Java oferă o alternativă pentru operatorul instanceof: metoda 
isInstance () aclasei Class. Această metodă are un avantaj față de 
operatorul instanceof: poate fi utilizată şi pe obiecte de tipul Class. 
De exemplu, este greşită o secvență de cod de tipul următor: 


i Class [] c = (Dacia.class, Opel.class, Ferrari. class }; 


sita m = new Dacia); 

oi (int i = 0; i < c.length; i++) 

i if (m instanceof c[i]) //EROARE 

j System .out.println("m este instanta a clasei " 
c[i]. getName ()); 


+ 


Eroarea este datorată faptului că operatorul instanceof nu poate fi 
folosit decât în conjuncție cu numele clasei (Dacia), şi nu cu un obiect 
de tipul Class (Dacia.class). Pentru a corecta această eroare, se 
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utilizează metoda isInstance (), înlocuind condiţia din instrucţiunea 
if, cu condiţia c[i].isIlnstance (m). Rezultatul execuţiei progra- 
mului astfel modificat este: 


m este instanta a clasei Dacia 


După cum se poate observa, metoda isInstance () oferă un mod di- 
namic de a apela operatorul instanceof. Ambele variante produc însă 
rezultate echivalente. 


Există o diferenţă importantă între operatorul instanceof (implicit şi metoda 
isInstance (), pentru că sunt operaţii cu rezultat echivalent) şi compararea 
folosind obiecte de tipul Class. Diferenţa este vizibilă la aflarea informaţiilor 
despre clase. Operatorul instanceof verifică dacă un obiect este o instanţă 
a unei clase specificate sau a unei clase derivate din clasa specificată, în timp 
ce compararea obiectelor de tipul Class nu ţine cont de moştenire, ci doar 
verifică strict dacă obiectul respectiv este o instanţă a clasei specificate sau nu. 
Pentru a verifica afirmaţiile anterioare, iată un exemplu: 


ı Masina m = new Dacia (); 
2 
3 System . out. printin ("m instanceof Masina " + 


4 (m instanceof Masina)); 

s System . out. println ("m instanceof Dacia " + 

6 (m instanceof Dacia )); 

7 

s System . out. println ("m. getClass () == Masina.class " + 

9 (m. getClass () == Masina. class )); 
10 System . out. println ("m. getClass () == Dacia.class "+ 

LI (m. getClass () == Dacia.class)); 


Secvența afişează următorul rezultat: 


m instanceof Masina true 

m instanceof Dacia true 
m.getClass() == Masina.class false 
m.getClass() == Dacia.class true 


5.8.2 Mecanismul de reflecţie ("reflection") 


Acest paragraf prezintă concepte mai avansate, care nu sunt necesare pentru 
înţelegerea informaţiei din restul lucrării. Dacă nu sunteţi direct interesaţi de 
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conceptul de reflection, puteţi sări deocamdată peste el şi veţi putea reveni ulte- 
rior, când bagajul de cunoştinţe acumulat vă va permite o înţelegere mai uşoară 
a lui. 

Pentru a putea afla tipul unui anumit obiect puteţi utiliza oricare dintre 
metodele anterioare, dar trebuie să aveţi în vedere că există o anumită limitare. 
Dezavantajul constă în faptul că tipurile de date trebuie să fie cunoscute în faza 
de compilare, chiar dacă ele sunt utilizate în faza de execuţie. Cu alte cuvinte, 
compilatorul trebuie să cunoască toate clasele care sunt utilizate pentru identi- 
ficarea tipurilor de date în faza de execuţie a programului. 

La prima vedere nu pare a fi o limitare, dar poate deveni în situaţia în care 
este necesară instanţierea unei clase care nu este disponibilă maşinii virtuale 
JVM în momentul compilării. Aceasta sună probabil în acest moment a science- 
fiction, dar în aplicaţiile concrete (în special cele client-server) această situaţie 
nu constituie o raritate. De exemplu, într-un fişier putem avea un şir de octeți 
care ştim că reprezintă o clasă. În faza de compilare, compilatorul nu poate afla 
nici o informaţie legată de acel şir de octeți, deci utilizarea unei astfel de clase 
pare imposibilă. Din fericire, platforma Java oferă o soluţie pentru această pro- 
blemă: mecanismul de reflecţie (reflection). Reflecţia este un mecanism prin 
care se pot determina informaţii despre o clasă (numele clasei, numele metode- 
lor, numele constructorilor, etc.) fără ca acea clasă să fie cunoscută compila- 
torului în faza de compilare. 

Clasa Class prezentată în paragraful anterior suportă conceptul de re- 
flecţie, dar majoritatea claselor specializate pentru acest mecanism se găsesc în 
pachetul java. lang.reflect. Câteva dintre aceste clase, Constructor, 
Field, Method, vor fi prezentate mai pe larg pe parcursul acestui subcapitol. 

În general, mecanismul de reflecţie este utilizat în mod direct destul de rar de 
programatori, dar există situaţii în care sunt de folos anumite informaţii legate 
de o clasă. De aceea vom prezenta, cu ajutorul unor exemple simple, cum se 
pot afla informaţii utile despre o clasă. 

Mediul de programare Java are la dispoziţie un API destul de bogat pentru 
a asigura funcţionalitatea mecanismului de reflecţie. API-ul reprezintă clasele, 
obiectele şi interfețele din maşina virtuală JVM şi permite operaţii de tipul: 


e determinarea clasei a cărei instanţă este un anumit obiect; 


e obţinerea de informaţii despre modificatorii de acces ai clasei, despre 
atribute, metode, constructori şi superclase; 


e obţinerea de informaţii despre constantele şi metodele declarate într-o 
interfaţă; 
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e instanţierea unei clase, al cărei nume este cunoscut doar în faza de exe- 
cuţie; 


e modificarea valorii unui atribut al unei clase, chiar dacă numele atributu- 
lui este cunoscut doar în faza de execuţie; 


e apelarea unei metode a unei clase, chiar dacă numele acestei metode este 
cunoscut doar în faza de execuţie. 


Obţinerea de informaţii despre o clasă 


Pentru a afla informaţii despre o clasă trebuie să obţinem obiectul de tipul 
Class asociat clasei respective, pentru că acel obiect deţine toate informaţiile 
legate de clasă. Folosind acest obiect se pot apela diverse metode ale clasei 
Class, care returnează obiecte de tipul Constructor, Field, Method, 
corespunzătoare constructorilor, atributelor şi respectiv metodelor definite în 
cadrul clasei. De asemenea, un obiect Class poate reprezenta chiar şi o inter- 
faţă, situaţie în care se pot afla informaţii despre constantele definite, metodele 
declarate etc. Evident, nu toate metodele clasei Class sunt potrivite într-o ast- 
fel de situaţie. De exemplu, nu este normal apelul metodei getConstructors, 
deoarece o interfaţă nu are constructori. 

Aşadar, primul pas care trebuie realizat pentru o obţine informaţii despre o 
clasă este obţinerea obiectului de tipul Class asociat clasei respective. Prin- 
cipalele metode de a realiza acest demers au fost prezentate de-a lungul acestui 
subcapitol, dar este util să le reamintim: 


e dacăexistăo instanţă a clasei respective, se utilizează metoda get Class, 
prezentă în orice clasă Java (care extinde clasa Object): 


new Ferrari); 


Ferrari f = 
= f. getClass (); 


Class c 


e dacă numele clasei este disponibil în faza de compilare, se utilizează su- 
fixul .class ataşat numelui clasei: 


Class c = Ferrari.class; 


e dacă numele clasei nu este disponibil în faza de compilare, dar devine 
disponibil în faza de execuţie, atunci se foloseşte metoda forName a 
clasei Class: 


Class c = Class .forName(" Ferrari"); 
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Dacă obiectul de tip Class a fost obţinut, pe baza lui se pot determina alte 
informaţii utile legate de clasa respectivă: 


e Numele clasei, utilizând o secvenţă de cod asemănătoare cu: 


new Ferrari); 


1 Ferrari f = 
= f. getClass (); 


2 Class c 
3 

4 // determina numele clasei 
s String name = c.getName(); 
6 

1 //afiseaza acest nume 

s System . out. println (name); 


Execuţia secvenţei anterioare are ca rezultat afişarea stringului "Ferrari". 


e Tipul de modificatoral clasei (public,protected,abstract,final, 
etc.)“: 
ı Ferrari f new Ferrari); 


2 Class c = f. getClass (); 


3 
4int m = c.getModifiers (); 


5 


6 if (Modifier.isPublic(m)) 
7 { 


8 System . out. println ("public"); 


9} 
10 


u if (Modifier.isFinal(m)) 
12 { 


13 System . out. println ("final"); 

14 } 

Secvența nu va afişa nimic, deoarece clasa Ferrari nu este declarată 
nici public, nici final. 


e Obiectul de tip Class asociat clasei de bază din care a fost derivată clasa 
respectivă (dacă este cazul): 


ı Ferrari f = new Ferrari); 
2 Class c = f. getClass (); 

3 Class sc = c. getSuperclass (); 

4 System .out.printin(sc.getName ()); 


“Pentru ca secvența sa funcţioneze trebuie importate clasele din pachetul 
java.lang.reflect. Analog şi pentru restul exemplelor. 
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Secvența va afişa stringul "Masina". 


e Obiectele de tip Class asociate interfeţelor pe care le implementează 
clasa respectivă (dacă este cazul): 


Class [] ci = c. getlnterfaces(); 


e Dacă este clasă sau interfaţă: 


1 Class c; 
2... 
3if (c.islnterface ()) 


aÍ 


5 


6} 


7... 


e Informaţii despre atributele clasei, utilizând metoda getFfields() a 
clasei Class (se pot determina numele, tipul, modificatorii de acces ai 
fiecărui atribut, sau chiar se pot da valori acestor atribute): 


1 Class c = Ferrari. class; 
2 Field [] fields = c.getFields(); 
for (int i = 0; i < fields.length; i++) 


ad 

5 String fieldName = fields[i ].getName(); 

6 String fieldType = (fields [i ].getType()). getName (); 
: 

8 System . out. println (fieldName + " " + fieldType )}; 

9) 


e Informaţii despre constructorii unei clase, utilizând metoda getCons- 
tructors () a clasei Class (se pot determina numele, lista parame- 
trilor constructorului, etc.): 


1 Class c = Ferrari. class; 

2 Constructor [] constr = c.getConstructors (); 
3 for (int i = 0; i < constr.length; i++) 

a] 

5 String name = constr[i ].getName(); 

6 

7) 


8... 
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e Informaţii despre metodele clasei, utilizând metoda getMethods () a 
clasei Class (se pot determina numele, tipul valorii returnate, lista ar- 
gumentelor metodei, sau se poate apela metoda în sine folosind metoda 
invoke () aclasei Method): 


1 Class c = Ferrari. class; 

2 Method [] methods = c.getMethods (); 

for (int i = 0; i < methods.length; i++) 
al 

5 String name = methods [i ]. getName (); 
6 

7) 


8... 


Obiectul de tip Class poate fi utilizat nu numai pentru a interoga clasele 
şi a afla diverse informaţii despre ele. Cu ajutorul lui se pot realiza şi instanţieri 
ale claselor, modificări ale atributelor, sau apelări ale metodelor. Iată câteva 
exemple de acest tip: 


e Crearea unei instanţe a unei clase se poate realiza prin intermediul metodei 
newIlnstance () aclasei Class, în două moduri, în funcţie de numărul 
de argumente al constructorului: 


— constructori fără argumente 


ı Object o = null; 


2 try 

3 { 

4 Class c = Class .forName ("Ferrari"); 
5 o = c.newlnstance (); 


6) 
7 catch (Exception e) 
a | 
9) 


— constructori cu argumente 


ı try 

2 | 

3 Class [] argsClasses = { String .class }; 

4 Object [] argsValues = {"12"}; 

5 

6 Class c = Class .forName("java.lang.Integer"); 

7 Constructor constr = c.getConstructor(argsClasses); 
8 
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9 Object i = constr.newlnstance(argsValues ); 
10 
11 System . out. println (i); 


12 } 


3 catch (Exception e) 
14 { 
15 ) 


Pentru o mai bună înţelegere a instanțierii prin reflection a unei clase 
cu ajutorul unui constructor cu parametri, vom prezenta mai amă- 
nunţit acest exemplu. Instrucţiunile folosite au ca rezultat crearea 
unui obiect de tip Integer, utilizând un constructor al acestei 
clase, care are ca parametru un obiect String. În esenţă, codul 
este echivalent cu secvenţa: 


String s = "12"; 
Integer i = new Integer(s); 


Pentru a realiza acest lucru, au fost create mai întâi şirul cu tipurile 
argumentelor (String) şi şirul cu valorile argumentelor ("12"). 
Apoi, pornind de la obiectul Class ataşat clasei Integer, s-a 
obţinut acel constructor al clasei Integer care primeşte ca para- 
metru un obiect String. În final, utilizând acest constructor s-a 
creat o instanţă a clasei Integer, cu argumentele specificate. În 
urma execuţiei se afişează valoarea "12". 


O diferenţă importantă faţă de varianta apelului constructorului fără 
parametri este aceea că newIlnstance () aparţine clasei Cons- 
tructor şi nu clasei Class ca în exemplul precedent. 


e Obţinerea valorii unui atribut dintr-o clasă se realizează cu ajutorul me- 
todei getField (). Aceasta returnează un obiect de tipul Field, care 
conţine datele despre atributul respectiv. Dacă tipul de dată al atribu- 
tului este primitiv, atunci valoarea atributului se obţine apelând una din 
metodele get Int (),getFfloat (),getBoolean (),etc., corespun- 
zător tipului primitiv de dată al atributului. Dacă atributul reprezintă un 
obiect, atunci trebuie utilizată metoda get () pentru a afla valoarea aces- 
tuia. Drept exemplu vom prezenta o secvenţă de cod ce obţine valoarea 
unui atribut (pentru aceasta presupunem că avem definită o clasă Audi, 
ce conţine atributul model de tip String): 


3 Audi a = new Audi("TI-Coupe"); 
4 Class c = a.getClass (); 
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5 
6 //obtine obiectul ce contine informatii despre model 
7 Field f = c.getField("'model”); 

8 //obtine valoarea atributului model pentru instanta a 
9 String s = (String) f.get(a); 


11 System . out. println ("Model = "+ s); 


12 } 


3 catch (Exception e) 
14 { 
15 ) 


e Similar metodelor get () (getInt (), getFloat (), get () etc.), 
clasa Field mai cuprinde şi metode set (setInt (),setFloat(), 
set () etc.) pentru a putea modifica valoarea atributului, setându-o la 
noua valoare dorită (pentru simplitate vom considera aceleaşi ipoteze ca 
la exemplul anterior): 


ı try 

2 | 

3 Audi a = new Audi("TI-Coupe”); 

4 Class c = a. getClass (); 

5 

6 // obtine obiectul ce contine informatii despre model 
7 Field f = c.getField("model"); 

8 

9 // modificam valoarea atributului model in "A4" 


10 // pentru instanta a 
ll f.set(a, "A4" ); 


3 catch (Exception e) 


14 { 
15 ] 


e Apelul unei metode oarecare a unei clase oarecare se poate realiza di- 
namic prin intermediul clasei Method. De exemplu, pentru a concatena 
două stringuri se poate utiliza metoda concat () aclasei String, ceea 
ce ar conduce, folosind apelul dinamic al metodei respective, la urmă- 
toarea secvenţă de cod ce afişează în final mesajul "Limbajul Java”: 


ı try 

2 { 

3 //obtinerea obiectului Class asociat clasei String 
4 Class c = String. class; 

5 

6 // definire tipuri si valori ptr. parametrii metodei 
7 //ce va fi apelata 

8 Class [] tipParam = { String .class }; 
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9 Object [] valParam = {"Java"}; 

10 

11 // obtine obiectul Method ce contine informatii legate 
12 //de metoda concat() cu lista de parametri specificata 
13 Method m = c.getMethod("concat", tipParam); 

14 

15 //apel dinamic metoda concat() pe obiectul "Limbajul " 
16 // echivalent cu: "Limbajul ".concat("Java "); 

17 String s = (String) m.invoke("Limbajul ", valParam); 
18 

19 // afisarea rezultatului concatenarii celor 2 siruri 

20 System . out. println (s); 


2) 


2 catch (Exception e) 


zf 


24 ) 


Exemplele prezentate de-a lungul acestui subcapitol denotă faptul că mecanis- 
mul de reflecţie permite ca informaţiile despre obiecte să fie complet determi- 
nate în faza de execuţie, fără nici o intervenţie în faza de compilare. Analizând 
comparativ identificarea standard a tipului de date şi mecanismul de reflecţie se 
poate spune că cea mai importantă diferenţă dintre cele două este că în primul 
caz compilatorul verifică în faza de compilare clasele, în timp ce în cel de-al 
doilea caz, clasele sunt verificate în timpul fazei de execuţie. 


Rezumat 


Mogştenirea este o caracteristică puternică, fiind esenţa programării orientate 
pe obiecte şi a limbajului Java. Ea permite abstractizarea funcţionalităţii în clase 
abstracte, pentru a deriva apoi din aceste clase, alte clase care implementează şi 
măresc funcţionalitatea de bază. 

Cea mai abstractă clasă, care nu implementează nimic poate fi specificată 
utilizând o interfață. Metodele specificate de o interfaţă trebuie definite de clasa 
care o implementează. 

Un alt tip special de clase sunt clasele interioare, care sunt clase definite în 
interiorul altor clase. Deşi mai puţin utilizate decât celelalte tipuri de clase, ele 
oferă facilităţi specifice şi au avantaje importante. 

Uneori este necesar să identificăm tipul unui obiect în faza de execuţie 
a programului. Deşi această facilitate nu va fi utilizată în cadrul acestei lu- 
crări, ea reprezintă un element sine qua non pentru programatorii care ajung să 
folosească tehnologii client-server cum ar fi CORBA sau EJB. 
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Capitolul următor este unul mult aşteptat, prin prisma numărului de referiri 
de care a avut parte de-a lungul capitolelor anterioare. Este vorba despre “Tra- 
tarea excepțiilor”. 


Noţiuni fundamentale 


cast: operator unar prin care o clasă este convertită la altă clasă. 

clasă abstractă: clasă care nu poate fi instanţiată, dar care înglobează func- 
țonalitatea comună a claselor derivate din ea. 

clasă anonimă: clasă locală care nu are nume. 

clasă de bază: clasă din care se derivează/implementează alte clase. 

clasă finală: clasă care nu mai poate fi derivată. 

clasă interioară: clasă definită în interiorul altei clase. 

clasă derivată: clasă complet nouă care moşteneşte funcţionalitatea clasei 
de bază. 

clasă locală: clasă interioară definită în interiorul unui bloc de cod. 

clasă wrapper: clasă care oferă un obiect ce stochează un tip primitiv. De 
exemplu, Integer este o clasă wrapper peste tipul primitiv int. 

Class: clasă specială ce conţine informaţii despre o clasă Java. 

constructor super: constructorul clasei de bază din care a fost derivată 
clasa de faţă. 

extends: cuvânt cheie prin care se specifică faptul că o clasă este derivată 
din altă clasă. 

implements: cuvânt cheie prin care se specifică faptul că o clasă imple- 
mentează metodele expuse de o interfaţă. 

instanceof: operator prin care se verifică dacă un obiect este o instanţă 
a unei clase specificate. 

interfaţă: tip special de clasă Java, care nu conţine nici un detaliu de im- 
plementare. 

mecanismul "reflection": permite obţinerea de informaţii despre o clasă 
în timpul fazei de execuţie a programului. 

moştenire: proces prin care se poate deriva o clasă nouă dintr-o clasă de 
bază, fără a afecta implementarea clasei de bază. Prin aceasta se poate crea o 
ierarhie de clase. 

moştenire multiplă: proces prin care o clasă este derivată din mai multe 
clase de bază. Acest lucru nu este permis în Java. Totuşi există o alternativă: 
implementarea mai multor interfeţe. 
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polimorfism: abilitatea unei variabile referinţă de a referi obiecte de tipuri 
diferite. Când se apelează o metodă pe această variabilă, se apelează de fapt 
metoda tipului de obiect referit în momentul respectiv. 


subclasă: denumire a clasei derivate. 


superclasă: denumire a clasei de bază. 


Erori frecvente 


l. 


2. 


Membrii private din clasa de bază nu sunt vizibili în clasa derivată. 


Dacă nu se defineşte nici un constructor în clasa derivată, iar clasa de 
bază nu are constructor implicit, se obține o eroare la compilare. 


„ Clasele abstracte nu pot fi instanțiate. 


. Dacă în clasa derivată uităm să implementăm o metodă definită abstractă 


în clasa de bază, atunci clasa derivată devine ea însăşi abstractă, ca şi 
superclasa ei. Aceasta va genera o eroare la compilare (evident, dacă nu 
declarăm clasa derivată ca fiind abstractă). Clasa derivată devine concretă 
doar în momentul în care a implementat metoda abstractă moştenită. 


. Metodele finale nu pot fi redefinite, iar clasele finale nu pot fi extinse. 


. Metodele statice folosesc legarea statică, chiar dacă sunt redefinite în 


clasele derivate. 


. În clasa derivată atributele moştenite de la clasa de bază ar trebui iniția- 


lizate ca un agregat, folosind metoda super. Dacă aceşti membri sunt 
public sau protected, ei vor putea fi ulterior modificaţi separat. 


Dacă o metodă generică întoarce o referinţă generică, atunci de obicei 
trebuie realizată o conversie de tip pentru a obţine obiectul efectiv retur- 


nat. 


Membrii claselor interioare anonime pot fi iniţializaţi doar cu atribute 
final ale clasei exterioare. 
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Exerciţii 


Pe scurt 


11. 


12. 


. Care membri din clasa de bază pot fi folosiți în clasa derivată? Care 


membri devin publici pentru utilizatorii claselor derivate? 
Ce este agregarea? 


Explicați polimorfismul. 


. Explicaţi legarea dinamică. Când nu se foloseşte legarea dinamică? 


Ce este o metodă final? 


Care este diferența dintre o clasă finală şi alte clase? Când se folosesc 
clasele final? 


Ce este o metodă abstractă? 
Ce este o clasă abstractă? 


Ce este o interfață? Prin ce diferă o interfață de o clasă abstractă? Ce fel 
de membri poate conține o interfață? 


. Cum sunt implementate componentele generice în Java? 


Ce este o clasă interioară şi de câte tipuri sunt clasele interioare? 


Prezentaţi pe scurt procesul de identificare a tipurilor de date în timpul 
fazei de execuție a programului. 


In practică 


l. 
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Scrieţi două metode generice min () şi max (), fiecare acceptând doi 
parametri de tip Comparable. Folosiţi metodele într-o clasă pe care o 
denumiți MyInteger. 


Scrieţi două metode generice min () şi max (), fiecare acceptând un şir 
de Comparable. Folosiţi apoi aceste metode pentru tipul My Integer. 


Adăugaţi a nouă clasă (de exemplu, Triunghi) la ierarhia de clase 
Shape şi verificaţi prin intermediul metodei de sortare dacă polimorfis- 
mul funcţionează ca şi în cazul claselor celelalte. 
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4. Creați o ierarhie de clase Felina, care să conţină clasele Pisica, 
Tigru, Leu, Leopard, Gheparăd etc. (pentru detalii consultaţi un 
atlas biologic...). Definiţi în clasa de bază metode care sunt comune 
pentru toate felinele, cum ar fi getNume (), getCuloare (), şi în 
fiecare clasă metode specifice fiecărei feline (de exemplu toarce), 
sau getSoarece() în cazul clasei Pisica). Redefiniţi unele din 
metodele clasei de bază în clasele derivate. Creați un şir de feline şi 
apelaţi metodele din clasa de bază pentru a vedea ce se întâmplă. 


5. Modificaţi exemplul anterior astfel încât clasa Felina sa fie o clasă ab- 
stractă. Definiţi metodele clasei Fel ina ca fiind abstracte ori de câte ori 
este posibil. 


6. Creați o clasă abstractă fără nici o metodă abstractă şi verificaţi faptul că 
nu o puteţi instanţa. 


7. Modificaţi exerciţiul 4 pentru a ilustra ordinea de construire a claselor 
de bază şi a celor derivate prin afişarea de mesaje în constructori. Apoi 
adăugaţi membri de tip referinţă la fiecare clasă şi urmăriţi ordinea în care 
sunt iniţializaţi aceşti membri. 


8. Creați o clasă de bază cu două metode, astfel încât prima metodă să o 
apeleze pe cea de-a doua. Derivați o clasă şi redefiniţi cea de-a doua 
metodă. Creați acum o instanţă a clasei derivate, convertiţi-o folosind 
operatorul de cast la clasa de bază şi apelaţi prima metodă. Explicaţi 
rezultatul. 


9. Modificaţi clasa Shape astfel încât ea să poată fi folosită de către un 
algoritm de sortare generic. 


Proiecte de programare 


1. Rescrieţi ierarhia de clase Shape pentru a reţine aria ca un membru pri- 
vat, care este calculat de către constructorul clasei Shape. Constructorii 
din clasele derivate trebuie să calculeze aria şi să trimită rezultatul către 
metoda super. Faceţi din area () o metodă finală care doar returnează 
valoarea acestui atribut. 


2. Adaugaţi conceptul de poziţie la ierarhia Shape prin includerea coordo- 
natelor ca date membru. Adaugaţi apoi o metodă distance. 


3. Scrieţi o clasă abstractă Date din care să derivați clasa GregorianDate 
(care reprezintă o dată în formatul nostru obişnuit). 
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6. Tratarea excepțiilor 


Dacă e verde, e biologie, dacă 
miroase urât e chimie, dacă are 
numere e matematică, dacă nu 
funcţionează e tehnologie. 


Autor necunoscut 
Nici o cantitate de experimente nu 
îmi poate valida teoria. Un singur 
experiment este însă suficient 
pentru a o infirma. 


Albert Einstein 


În capitolul anterior am prezentat concepte importante ale programării ori- 
entate pe obiecte, cum ar fi moştenirea, polimorfismul, programarea generică şi 
clasele abstracte. În acest capitol vom prezenta modul în care se pot trata ele- 
gant erorile care apar inevitabil în timpul execuţiei unui program folosind din 
plin principiile prezentate până acum. 

Vom afla în curând: 


e Ce constituie o situaţie de eroare în Java; 
e Ce sunt excepţiile şi de câte tipuri sunt ele; 
e Care este ierarhia de excepţii în limbajul Java; 


e Cum sunt folosite excepţiile pentru a semnala situaţii de eroare. 


6.1 Ce sunt excepţiile? 


Programatorii cunosc faptul că erori apar în orice aplicaţie software, indife- 
rent de limbajul în care aceasta a fost scrisă. Dar ce se întâmplă după ce aceste 


178 


6.1. CE SUNT EXCEPŢIILE? 


erori apar? Este posibil ca programul să le trateze şi să îşi reia mersul normal 
al execuţiei sau este pur şi simplu forţat să se termine? Dacă este posibilă 
tratarea lor, atunci cum este ea realizată şi de cine? Capitolul de faţă încearcă 
să răspundă tuturor acestor întrebări. 

Java foloseşte noţiunea de excepţie pentru a oferi posibilitatea de tratare a 
erorilor pentru programele scrise în acest limbaj. Excepţia poate fi considerată 
ca un eveniment care are loc în timpul execuţiei unui program, prin care este 
afectată (întreruptă) secvenţa de execuţie normală a instrucţiunilor din acel pro- 
gram. Excepţiile reprezintă modul în care Java indică o situaţie anormală (de 
eroare) semnalată în procesul de execuţie a unei metode apelate. 

Ca în orice alt limbaj de programare, în Java, erorile pot apare în ambele 
faze ale implementării unei aplicaţii software: compilare şi execuţie. Momentul 
ideal pentru a descoperi erorile dintr-un program este cel al compilării, înainte 
de a încerca execuţia programului. Totuşi, nu toate erorile pot fi descoperite în 
faza de compilare. Unele dintre ele nu pot fi detectate şi, implicit, tratate decât 
în faza de execuţie a programului (run-time). În Java, tratarea erorilor în faza 
de execuţie a unui program este posibilă prin intermediul excepțiilor. 

Există numeroase tipuri de erori care pot provoca situaţii de excepţie, împie- 
dicând astfel execuţia normală a unui program. Aceste probleme pot varia de la 
defecţiuni serioase de hardware, cum ar fi distrugerea parţială a unui hard-disk, 
până la simple erori de programare, cum ar fi accesarea într-un şir a unui ele- 
ment de pe o poziţie mai mare decât lungimea şirului. Când o eroare de acest tip 
are loc în cadrul unei metode Java, metoda respectivă crează un obiect de tip ex- 
cepţie pe care îl predă apoi sistemului, sau cu alte cuvinte, maşinii virtuale JVM. 
Rezultă de aici că excepţiile sunt şi ele nişte clase Java obişnuite. Obiectul de tip 
excepţie care este predat sistemului conţine informaţii despre excepţia generată, 
incluzând tipul ei şi starea programului în momentul în care eroarea a apărut. 
Sistemul este apoi responsabil pentru a găsi secvenţa de cod care tratează ex- 
cepţia întâlnită. În terminologia Java, crearea unei excepţii şi predarea ei către 
sistem poartă numele de aruncare de excepții (operaţia throw). 

După ce excepţia a fost predată sistemului, este sarcina acestuia de a des- 
coperi codul care tratează excepţia respectivă. Sistemul "ştie" unde să caute 
acest cod, datorită următorului fapt: în Java, apelul unei metode este urmat 
de păstrarea sa în cadrul unei stive de apel (call stack). Astfel, dacă metoda 
main () a unui program Java apelează o metodă, să spunem metoda (), 
atunci în stivă se adaugă metoda main () urmată de metoda metodaA (). 
Dacă metoda metodaA (), apelează o altă metodă metodaB (), atunci cea 
din urmă este adaugată şi ea în stivă. Practic, în acest fel, se poate cunoaşte 
pentru fiecare metodă în parte, de cine a fost apelată, prin parcurgerea stivei de 
apel de la vârf spre bază (pentru exemplul nostru, metodaB () a fost apelată 
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de metodaA (), care la rândul ei a fost apelată de metoda main ()). Acest 
mod de a reţine apelul unei metode este cheia soluţiei pe care maşina virtu- 
ală o utilizează în tratarea excepțiilor. Maşina virtuală caută în stiva de apel 
metoda care tratează excepţia, pornind de la metoda în care a apărut eroarea, 
deci dinspre vârful stivei spre bază. Sistemul consideră căutarea încununată de 
succes în momentul în care găseşte o metodă din stiva de apel care tratează o 
excepţie de acelaşi tip cu excepţia aruncată de metoda în care a apărut eroarea. 
Codul care tratează excepţia respectivă reprezintă, în terminologia Java, codul 
care prinde excepţia (operaţia catch). Metoda în care poate apare acest cod, 
diferă de la un caz la altul. Excepţia poate fi prinsă chiar în metoda în care a 
fost generată, sau, dimpotrivă, în metodele predecesoare din stiva de apel. Ca 
exemplu, dacă o excepţie a fost aruncată în metodaB, ea poate fi prinsă tot în 
metodaB, sau în metodaA, sau în metoda main. În majoritatea cazurilor de 
excepţii este obligatoriu ca excepţia aruncată să fie prinsă în cadrul uneia din 
metodele din stiva de apel. Există însă anumite cazuri, care vor fi prezentate 
pe parcursul acestui subcapitol, în care se poate întâmpla ca o excepţie să fie 
aruncată în cadrul unei metode, dar să nu fie prinsă în nici o altă metodă din 
stiva de apel. În acest caz, programul Java este oprit din execuţie iar excepţia 
este afişată la terminal. 


În concluzie, aruncarea unei excepţii poate fi văzută ca un semnal de alarmă, 
care indică sistemului că a apărut o problemă pe care trebuie să o trateze pentru 
ca execuţia programului să poată continua. Semnalul este tras în speranţa că 
una dintre metodele anterior apelate (cele din stiva de apel) va reacţiona şi va 
trata problema, iar programul îşi va putea continua astfel execuţia. 


6.2 Tipuri de excepţii 


În Java, excepţiile sunt obiecte. Când este aruncată o excepţie, este aruncat 
de fapt un obiect, o instanţă a unei clase de excepţie. Nu orice tip de obiect 
poate fi însă aruncat ca excepţie. Excepţii pot fi doar obiectele care sunt instanţe 
ale unor clase derivate din clasa Throwable. Clasa Throwable, definită în 
pachetul java. lang, reprezintă clasa de bază pentru întreaga familie de clase 
de excepţii. 
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Figura 6.1: Ierarhia claselor de excepţii ale limbajului Java (pe scurt) 


Throwable 


RuntimeExceptiorn 


Arithmetic Exception NullPointerException 


Figura 6.1 ilustrează ierarhia claselor de excepții, pornind de la clasa de 
bază Throwable şi continuând cu câteva dintre subclasele cele mai impor- 
tante. După cum se observă, clasa Throwable are doi descendenți direcți 
(clase derivate direct din clasa Throwable): Error şi Exception. 

Clasa Error, împreună cu toate clasele derivate din ea, descrie excepții 
grave, numite erori. Erorile reprezintă greşeli de compilare sau probleme mai 
serioase ale fazei de execuție a programului, probleme care în general nu pot 
fi tratate şi necesită întreruperea execuției programului (de exemplu, OutOf- 
MemoryError). În general, codul scris de programator nu ar trebui să arunce 
erori, ci doar excepții. De asemenea, programele Java obişnuite nu ar trebui 
să prindă erori, deoarece este puțin probabil ca erorile să poate fi în vreun fel 
tratate. 

Clasa Exception, împreună cu toate clasele derivate din ea, reprezintă 
excepții. Excepțiile sunt aruncate pentru a semnala condiții anormale, care 
sunt deseori tratate de aplicație, deşi există situații în care este posibil ca ex- 
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cepţiile respective să nu fie prinse şi atunci aplicaţia va fi oprită din execuţie. 
Cele mai multe programe aruncă şi prind instanţe ale unor clase derivate din 
clasa Exception, de aceea Exception este clasa cea mai importantă pen- 
tru programator din acest punct de vedere. Clasa Exception are mulţi de- 
scendenţi definiţi în cadrul pachetului java.lang. Aceste clase indică di- 
verse tipuri de excepţii care pot apărea în cadrul unui program Java. De ex- 
emplu, NoSuchMethodException indică faptul că programul a încercat 
să apeleze o metodă care nu există. Nu toate excepţiile sunt definite în pa- 
chetul java.lang. Unele dintre ele sunt create pentru a oferi suport pa- 
chetelor net, util, io etc. De exemplu, toate excepţiile 1/O sunt derivate 
din java.1o.IOException şi sunt definite în pachetul java.io. 

Există o subclasă a clasei Exception, care are o însemnătate specială 
în limbajul Java: RuntimeEkxception. Clasa RuntimeException este 
clasa de bază pentru excepţiile care apar în timpul execuţiei unui program (ex- 
cepţii runtime). Pachetele Java definesc multiple clase pentru excepţii runtime. 
Un exemplu des întâlnit este clasa NullPointerException, care apare în 
momentul în care se încearcă accesarea unui membru (atribut sau metodă) al 
unui obiect, prin intermediul unei referinţe nule. 

Costul verificării excepțiilor runtime depăşeşte deseori avantajul de a le 
prinde, motiv pentru care compilatorul Java permite ca excepţiile runtime să 
nu fie prinse sau specificate. De asemenea, excepţiile runtime pot apărea prac- 
tic în orice secvenţă de cod, motiv pentru care obligativitatea de a le prinde ar 
fi generat un cod greoi şi obscur, umplut peste măsură cu secvenţe de tratare a 
excepțiilor. Aceasta este cerința pentru ca o excepţie să poată fi aruncată fără a 
fi prinsă: să fie instanţă a unei clase derivate din RuntimeException. 

Excepţiile se împart în două mari categorii: 


e tratate (checked); 


e netratate (unchecked). 


Excepţiile tratate sunt denumite astfel pentru că atât compilatorul Java cât şi 
maşina virtuală JVM verifică dacă excepţiile aruncate în cadrul unei metode 
sunt fie tratate în cadrul acelei metode, fie specificate ca fiind aruncate mai 
departe de metoda respectivă, urmând a fi tratate în alte metode. 

O clasă de excepţii este tratată sau netratată, în funcţie de poziţia ei în ie- 
rarhia claselor de excepţii (cu clasa de bază Throwable). Potrivit acesteia, 
se consideră excepţie tratată, orice clasă derivată din clasa Exception, inclu- 
siv clasa Exception, mai puţin clasa Runt imeException şi subclasele ei. 
Toate celelalte clase de excepţii (clasa Throwable, clasa Error şi subclasele 
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ei), împreună cu clasa RuntimeException şi subclasele ei, reprezintă ex- 
cepţii netratate. 

Diferenţa conceptuală dintre excepţiile tratate şi cele netratate este că primele 
semnalează situaţii anormale de care programatorul este obligat să ţină seama. 
Cu alte cuvinte, aruncarea excepțiilor tratate în cadrul unei metode, obligă pro- 
gramatorul să le prindă şi să le trateze mai devreme sau mai târziu în cadrul 
aplicaţiei sale. Compilatorul este cel care îl obligă pe programator să trateze 
excepţiile respective. În cazul excepțiilor netratate, programatorul poate decide 
dacă prinde sau trece cu vederea excepţia. De altfel, este posibil ca programa- 
torul nici să nu ştie că excepţia netratată poate fi aruncată în cadrul metodei. Ca 
o consecinţă, este de la sine înţeles că nici compilatorul nu obligă programatorul 
să trateze excepţia respectivă. 

Utilizarea excepțiilor nu este nicidecum limitată doar la cele definite de plat- 
forma Java. Pe lângă aceste clase, programatorul poate defini propriile clase de 
excepţii. Acest lucru este foarte important, pentru că deseori un programator 
simte nevoia să creeze propriile sale excepţii, pentru a înfăţişa o situaţie specială 
de eroare, pe care programul său este capabil să o producă, dar care nu a fost 
prevăzută la crearea ierarhiei de excepţii. Această situaţie este perfect normală, 
deoarece creatorii limbajului Java nici nu ar fi putut să anticipeze toate situaţiile 
de eroare ce pot apare în aplicaţii existente sau viitoare. Crearea propriilor ex- 
cepţii este chiar încurajată, deoarece regula generală este ca programul să fie cât 
mai precis. De aceea, programatorii nu trebuie să utilizeze excepţii ambigue, de 
tipul Exception, ci subclase ale acestora, pentru a nuanţa cât mai bine ex- 
cepţia apărută. De exemplu, dacă în cadrul programului nostru a fost citit un 
nume de utilizator invalid, atunci este de preferat să definim, să aruncăm şi să 
prindem o excepţie de genul InvalidUserNameException. În continua- 
re, vor fi prezentate cele mai importante amănunte legate de crearea propriilor 
clase de excepţii. 


6.3 Definirea propriilor excepţii de către progra- 
mator 


eqe vu. oœ 


e utilizarea unor excepții predefinite sau definite de alţi programatori (de 
exemplu, clasele de excepții cuprinse în platforma Java) ; 


e utilizarea unor excepții proprii, definite de programator. 
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Pachetele oferite de platforma Java oferă numeroase clase de excepţii. Toate 
aceste clase sunt derivate direct sau indirect din clasa Throwable şi permit 
programatorului să diferenţieze diversele tipuri de excepţii care pot să apară 
de-a lungul execuţiei unui program. 

Platforma Java permite şi crearea propriilor clase de excepţii pentru a în- 
făţişa situaţii problematice specifice care pot să apară în cadrul programelor. 
Deşi necesitatea de a avea clase proprii de excepţii poate să pară exagerată, to- 
tuşi aceasta devine evidentă în cazul în care clasele scrise de programator vor fi 
reutilizate de către alţi programatori. În astfel de situaţii, programatorul trebuie 
să îşi creeze propria structură de clase de excepţii pentru a permite utilizatorilor 
claselor sale să diferenţieze o eroare apărută în clasele sale, de erori apărute în 
clase scrise de alţi programatori. Un alt motiv pentru care programatorii ape- 
lează la definirea de excepţii proprii este nevoia de a avea o excepţie care nu 
există în ierarhia de clase de excepţii oferită de platforma Java, şi care descrie o 
situaţie de excepţie particulară aplicaţiei respective. 

Ca şi clasele de excepţii predefinite de platforma Java, clasele proprii de 
excepţii trebuie să extindă (direct sau indirect) clasa Throwable. O primă 
tentaţie ar fi aceea de a extinde direct clasele proprii de excepţie din clasa 
Throwable. La o privire mai atentă, se poate observa că Throwable are 
două subclase, Error şi Exception, care împart în două erorile posibile 
dintr-un program Java. Marea majoritate a programelor Java utilizează excepţii 
derivate din Exception, deoarece excepţiile de tip Error sunt rezervate pen- 
tru probleme mult mai complexe care au loc în cadrul sistemului (maşinii vir- 
tuale JVM). În definirea noilor excepțiilor, se consideră o bună practică adău- 
garea la numele clasei a sufixului Exception pentru toate clasele derivate (di- 
rect sau indirect) din Exception (de exemplu, TeaTooHotException). 
Evident, analog se procedează şi în cazul (mult mai rar) al claselor derivate 
(direct sau indirect) din Error. 

Deoarece clasele proprii de excepţii sunt clase Java obişnuite, ele pot în- 
globa informaţii despre situaţia anormală care a condus la aruncarea lor. Astfel, 
se pot transmite informaţii utile către partea de program care tratează respectiva 
situaţie de eroare. 

În general, clasele proprii de excepţii sunt implementate astfel: 


Listing 6.1: Clasa TeaTooHotException 
ı public class TeaTooHotException extends Exception 
2 { 
3 public TeaTooHotException () 
4 { 
5 
6 


) 


super (); 
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8 public TeaTooHotException (String s) 
9 { 


10 super (s ); 


Ll } 


Clasa TeaTooHotException nu aduce practic nimic nou clasei Excep- 
tion, deoarece defineşte doar doi constructori care apelează constructorii din 
clasa de bază. Totuşi, tipul excepţiei în sine este foarte important: el ne ajută 
să discernem în momentul în care prindem excepţia despre ce fel de eroare este 
vorba. 

Folosind definirea anterioară, utilizatorul clasei de excepţii va putea arunca 
o excepţie în două moduri: 


new TeaTooHotException (); 
new TeaTooHotException ("Ceaiul este foarte fierbinte"); 


Este uşor de observat că în cel de al doilea caz situaţia de eroare transmite şi 
o informaţie, sub forma mesajului "Ceaiul este foarte fierbinte", 
care poate fi folosit de codul care tratează excepţia apărută pentru a afişa un 
mesaj informativ. 

Informaţiile transmise de excepţii nu se limitează doar la mesaje de tip 
String. Dacă mesajul String nu este suficient pentru a îngloba întreaga in- 
formaţie dorită, se pot adăuga date noi clasei de excepţii, sub forma atributelor 
şi metodelor. 

Listing 6.2 prezintă o variantă modificată a clasei TeaTooHotException 
care înglobează în informaţiile transmise şi temperatura ceaiului (engl. tea) din 
exemplul nostru. 


Listing 6.2: Clasa TeaTooHotException (versiune modificată) 


public class TeaTooHotException extends Exception 
{ 


int temperature ; 


[ 
super (); 


) 


l 

2 

3 

4 

s public TeaTooHotException () 
6 

7 

8 

9 


o public TeaTooHotException (String s) 
uo f 


12 super (s); 
3) 
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5 public TeaTooHotException (int temperature) 


6 4 


17 this.temperature = temperature ; 


8) 


2 public int getlTemperature () 


a 4 
22 return temperature 5 
2 e) 


Constructorul cu argument de tip int ne permite să creăm o excepție care 
înglobează ca informație temperatura ceaiului prea fierbinte (engl. too hot) pen- 
tru a fi consumat. lată un exemplu de utilizare a acestui constructor: 


new TeaTooHotException (70); 


În momentul în care excepţia este prinsă şi tratată, undeva în cadrul apli- 
caţiei, se vor putea obţine informaţii suplimentare referitoare la temperatura 
care a provocat excepţia TeaTooHotException, utilizând metoda get- 
Temperature (). 

În cele mai multe cazuri o asemenea abordare nu este necesară şi singura 
informaţie (esenţială) legată de excepţie este tipul obiectului creat (cu alte cu- 
vinte, numele clasei), fără alte informaţii adiacente stocate în cadrul obiectului 
respectiv. 


6.4  Prinderea şi tratarea excepțiilor 


Când o metodă aruncă excepţii, ea presupune că acestea sunt prinse şi tratate 
undeva în cadrul aplicaţiei. Pentru prinderea şi tratarea lor, Java pune la dispo- 
ziţia programatorilor trei cuvinte cheie, care vor fi descrise în continuare: 


e try 
e catch 


e finally 


6.4.1 Blocultry 


Primul pas în prinderea şi tratarea excepțiilor este acela de a "îngrädi" in- 
strucţiunile care pot genera excepţii într-un bloc de instrucţiuni, denumit bloc 
try. Blocul try cuprinde instrucţiunile care pot arunca excepţii. În general, 
un bloc try arată astfel: 
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3 //instructiuni care pot genera exceptii 
4 instructiuni; 


5} 


Blocul try ține sub observaţie toate instrucțiunile pe care le conține, în aş- 
teptarea unei excepții aruncate de una dintre respectivele instrucțiuni. El poate 
fi văzut ca un bloc de instrucțiuni care sunt "încercate" (try = a încerca), urmând 
ca, în cazul în care ele nu se pot executa cu succes, eroarea să fie tratată. Evident 
că, dacă instrucțiunile se execută fără a genera probleme, nu mai poate fi vorba 
de tratarea excepțiilor şi aplicația se va executa normal, fără a ține cont de partea 
de tratare a excepțiilor. Acesta reprezintă un mare avantaj oferit de modul de 
gestionare a erorilor în limbajul Java. Astfel, programatorului îi este permis să 
se concentreze asupra problemei pe care încearcă să o rezolve, fără a-şi pune 
problema eventualelor erori care pot fi generate de codul lui. Aceste erori sunt 
tratate ulterior. Din acest motiv, codul devine mult mai uşor de scris şi de citit, 
deoarece scopul pentru care codul a fost scris nu se mai confundă cu verificarea 
eventualelor erori. 

Unui bloc try i se asociază obligatoriu unul sau mai multe blocuri catch 
şi, opţional, un bloc finally. 


6.4.2 Blocul catch 


Blocul catch reprezintă locul în care sunt prinse şi tratate excepţiile. Blo- 
curile catch nu pot exista independent, ele apar doar în asociere cu un bloc 


try: 


ı try 

2 | 

3 

a} 

5s catch (...) 
6 | 

7 

8} 

o catch (...) 


10 { 


Între blocul try şi primul bloc catch nu pot exista instrucțiuni intermedi- 
are. Forma generală a unui bloc catch este următoarea: 


ı catch (ClasaDeExceptii numeVariabila) 
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2 | 
3 instructiuni; 


4) 


După cum se poate observa, instrucţiunea catch necesită un singur pa- 
rametru formal, notat numeVariabila. Modul de definire a instrucţiunii 
catch este foarte asemănător cu cel de definire a argumentelor unei metode 
Java, unde lista argumentelor unei metode era compusă din perechi de tipul 
numeClasa şi numeVariabila, separate prin simbolul ",". În cazul excepțiilor, 
ClasaDeExceptii reprezintă tipul de excepţie care poate fi tratat, specificat 
prin numele clasei de excepţie, derivată din Throwable. Parametrul formal, 
numeVariabila, reprezintă numele prin care poate fi referită excepţia tratată 
de blocul catch. Excepţia poate fi referită prin acest nume doar în cadrul 
blocului catch, pentru că durata de viaţă a variabilei numevariabila se 
rezumă doar la blocul catch. Deseori variabila numevariabila nu este 
utilizată, pentru că tipul clasei de excepţie oferă îndeajuns de multă informaţie 
programatorului. Totuşi, numele variabilei trebuie întotdeauna specificat, chiar 
dacă nu este utilizat niciodată în cadrul blocului cat ch. Pentru un exemplu de 
utilizare a blocurilor try-catch, să presupunem că încercăm accesarea unui 
element într-un şir: 

Lint[] s = (4, 1, 8, 7}; 

2 try 

3 

4 System .out.println(s[6]); 

5 

6 adi (ArrayIndexOutOfBoundsException exc) 
: 

d exc .printStackTrace (); 


9} 


Încercarea de a accesa un element care nu există în şirul s (acesta are 
4 elemente, deci nu poate fi vorba de un element pe poziția 6) va arunca o 
excepţie, ArrayIndex0utOfBoundsException. Aceasta este una din- 
tre multiplele excepții predefinite de limbajul Java, derivată indirect din clasa 
Throwable şi aflată în pachetul java.lang. Excepţia astfel aruncată este 
prinsă de blocul cat ch asociat, care specifică faptul că tratează excepţii Array- 
Index0utOfBoundsException. Faptul că excepţia aruncată a fost prinsă 
de acest bloc catch, presupune că tot acest bloc o va şi trata. Prin urmare, 
se execută instrucţiunile cuprinse în cadrul blocului catch, care sunt create 
pentru a trata cazul de eroare apărut. Excepţia apărută este referită în cadrul 
blocului catch prin intermediul numelui exc. Variabila exc este o instanţă 
a clasei ArrayIndex0utOfBoundsExcept ion, care este un obiect Java 
cu metode şi atribute. Deoarece toate clasele de excepţii sunt derivate din clasa 
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Throwable, ele moştenesc câteva metode utile pentru aflarea de informaţii de- 
spre situaţia de eroare. Printre aceste metode se află printStackTrace), 
getMessage (),toString(), fiecare dintre ale afişând informaţii care di- 
feră în cantitate şi calitate de la un caz la altul. Pentru exemplul nostru, instrucți- 
unea exc .printStackTrace () va afişa următorul mesaj (Exc . java este 
numele fişierului care conţine exemplul): 


jJava.lang.ArrayIndex0utOfBoundsException 
at Exc.main (Exc.java:8) 


Instrucţiunile din blocul catch se execută doar dacă instrucţiunile din 
blocul try generează excepţii şi aceste excepţii sunt instanţe ale clasei pre- 
definite Array Index0utOfBoundsException. Este de la sine înţeles că 
dacă s-ar fi încercat accesarea unui element de pe o poziţie mai mică decât 
lungimea şirului (de exemplu s[2]), nu ar mai fi fost o situaţie de eroare 
ŞI, implicit, excepţia ArrayIndex0utOfBoundsException nu ar mai fi 
fost aruncată, iar instrucţiunea din cadrul blocului try s-ar fi executat corect, 
afişând elementul de pe poziţia 2 din şir (adică, 8). 

Pentru ca un bloc catch să prindă şi să trateze o excepţie, nu este necesar 
ca tipul de excepţie tratat de blocul catch şi tipul de excepţie aruncat de o 
metodă din blocul try să fie identice. Un bloc catch, care tratează un tip de 
excepţii, va prinde şi trata şi clasele de excepţii derivate din excepţia respectivă. 
Cu alte cuvinte, în exemplul de faţă, nu este necesar să prindem excepţia creată 
folosind clasa ArrayIndex0utOfBoundsException. Deoarece această 
clasă de excepţii este derivată din Exception, codul ar putea arăta şi aşa: 


Lint[] s = (4, 1,8, 7); 
2 try 


4 System . out. println (s [6]); 
5} 


6 catch (Exception exc) 


7{ 


8 exc .printStackTrace (); 


9) 


În această situaţie, blocul catch prinde toate excepţiile Exception, dar 
şi clase de excepţii derivate din clasa Exception, cum este şi cazul cla- 
sei de excepţii ArrayIndex0utOfBoundsException. Practic, în acest 
mod, se prind mai multe excepţii cu acelaşi bloc catch, deoarece acest bloc 
prinde toate excepţiile de tip Exception, plus clasele de excepţii derivate din 
aceasta. Dacă se foloseşte această abordare, de a avea un bloc catch pentru 
mai multe excepţii generate, atunci codul de tratare a situaţiei de eroare devine 
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prea general, pentru că excepţia tratată de blocul catch nu este specializată, 
cu alte cuvinte este o clasă de bază pentru alte clase de excepţii. Din această 
cauză, se preferă utilizarea blocurilor cat ch specializate, şi nu a celor gene- 
rale, pentru că ele pot oferi mai multe detalii despre situaţia de eroare. Totuşi, 
cazul Exception este şi el important, pentru că astfel se pot prinde şi trata 
toate tipurile de excepţii aruncate într-un mod unitar (Exception este clasa 
de bază a tuturor excepțiilor de programare). 

Un alt aspect important care trebuie înţeles în legătură cu tratarea excepţi- 
ilor este că Java presupune că problema care a generat excepţia este atât de 
critică, încât nu se poate realiza întoarcerea la instrucţiunea care a generat-o, cu 
alte cuvinte nu se poate reface situaţia dinaintea apariţiei erorii. Acest aspect 
este foarte important pentru cei care cred că tratarea unei excepţii presupune re- 
alizarea unor operaţii care să îndrepte situaţia, iar apoi metoda care a generat-o 
să fie executată din nou, în speranţa că a doua tentativă va fi încununată de suc- 
ces. Java nu realizează acest lucru. După ce excepţia a fost tratată, se execută 
în continuare următoarea linie de cod aflată după secvenţa catch. Totuşi, se 
poate folosi un mic truc, care să ofere această posibilitate, şi anume, instrucţi- 
unea care generează eroarea să fie plasată în cadrul unui ciclu (for, while, 
do). 

Este foarte posibil ca într-un bloc try să existe instrucţiuni care pot gene- 
ra excepţii de mai multe tipuri. Aceste excepţii pot fi tratate separat, asociind 
blocului try mai multe blocuri catch. De exemplu, putem avea o metodă 
drinkTea (), care aruncă două excepţii, TeaTooHotException şi Tea- 
TooColdException, ambele clase fiind derivate din Exception. În con- 
secinţă, am putea avea următorul cod: 


ı //temperatura ceaiului 


2 int temperature = 25; 

3 

4 try 

s { 

6 drinkTea (temperature ); 


7) 
s catch ( TeaTooHotException hotExc) 


9 { 
10 hotExc .printStackTrace (); 


u} 
2 catch (TeaTooColdException coldExc) 


13 f 
14 coldExc.printStackTrace (); 


I5 } 


Utilizarea mai multor blocuri catch asociate unui bloc try trebuie să țină 
cont de anumite reguli, care vor fi prezentate în continuare. 
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Blocurile cat ch sunt examinate în ordinea în care ele apar în fişierul sursă. 
În timpul procesului de examinare, primul bloc care este în măsură să trateze 
eroarea, o va face, iar celalte blocuri nu vor mai fi luate în considerare, deşi 
ele ar putea, la rândul lor, să trateze respectiva excepţie. De aceea, ordinea 
blocurilor catch contează. Totodată, un bloc care tratează o excepţie generală 
nu se poate afla înaintea unui bloc care tratează o excepţie specializată, derivată 
din cea generală, deoarece secvenţa de tratare specializată nu ajunge să fie ex- 
ecutată niciodată. Pentru exemplul nostru, putem considera excepţia generală 
Exception, iar excepţia specializată ca fiind TeaTooHotException, care 
este derivată din excepţia generală. Ordinea blocurilor cat ch este obligatoriu 
următoarea: 


ı // temperatura ceaiului 


> int temperature = 25; 

3 

4 try 

5 { 

6 drinkTea (temperature ); 


$ 
s catch (TeaTooHotException hotExc) 


9 { 
10 hotExc .printStackTrace (); 


u} 


2 catch (Exception exc) 


3 { 


14 exc. printStackTrace (); 


5 ] 


Ordinea este logică, pentru că, dacă ar fi fost posibilă inversarea ordinii 
celor două excepții, atunci Exception ar fi fost tot timpul excepția prinsă, în 
timp ce TeaTooHotException ar fi fost imposibil de prins, deci codul de 
tratare a acestei excepții nu ar fi fost executat niciodată. Aşadar, regula generală 
este că blocurile catch care tratează subclase de excepții trebuie să precedeze 
blocurile catch ce tratează superclase. 


6.4.3 Blocul finally 


Din momentul în care maşina virtuală JVM începe să execute un bloc try, 
ea poate avea mai multe posibilități de a ieşi din acel bloc. Ar putea întâlni 
în cadrul blocului instrucțiuni de tipul break, continue, return, care să 
cauzeze ieşirea prematură din bloc. Pe de altă parte, diferitele excepții aruncate 
de codul din blocul t ry ar putea avea drept rezultat o altă întrerupere prematură 
a executării codului din acel bloc. 

Există multe situații în care este de o importanță vitală să se execute anumite 
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instrucţiuni la ieşirea din blocul try, indiferent de modul în care această ieşire 
se realizează. De exemplu, dacă într-un bloc try este deschis un fişier pentru 
a scrie date în el, este de dorit o secvenţă de cod care să îl închidă, indiferent de 
cum se termină execuţia blocului de scriere. Existenţa unei astfel de secvenţe 
de cod este necesară şi în situaţia în care se doreşte eliberarea anumitor resurse 
utilizate în blocul try, cum ar fi fluxurile de date etc. Pentru a realiza acest 
deziderat, mediul de programare Java oferă noţiunea finally. 

Clauza finally poate fi utilizată doar în asociere cu un bloc try. Ea con- 
stă, ca şi blocul try, dintr-un bloc de instrucţiuni care permite ca o secvenţă 
de cod să fie executată, indiferent dacă blocul try aruncă sau nu excepţii. Prin 
clauza finally, instrucţiunea try-catch devine completă, având urmă- 


toarea sintaxă: 


ı try 

2 | 

3 //instructiuni care pot arunca exceptii 

4 

5} 

6 catch (El el) 

74 

8 //instructiuni care trateaza exceptii de tipul El 
9 // si exceptii derivate din clasa de exceptii El 


LO 


u} 
ı2 catch (E2 e2) 


3 f 


14 // instructiuni care trateaza exceptii de tipul E2 
15 // si exceptii derivate din clasa de exceptii E2 


7) //numarul de blocuri catch este variabil 


8 finally 

19 | 

20 // instructiuni care se executa indiferent de ce 
21 //se intampla in blocul try 


Pentru o mai bună înţelegere a blocului finally să considerăm programul 
din Listing 6.3, în care avem o aplicaţie care deschide (sau crează dacă nu 
există) un fişier stocat pe hard-disk şi scrie în el un şir de numere întregi. 


Listing 6.3: Program de test pentru clauza finally 


ı // Nume fisier: TestFinally.java 
2 

3 import java.io.x; 

4 

s public class TestFinally 
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6 { 
7 public static void main(String [] args) 
8 
{ 
9 PrintWriter pw = null; 
10 int[] s = (3, 7, 4,6]; 
T String msg = ""; 
12 
13 try 
14 í 
15 msg = "Se incearca deschiderea fisierului... "; 
16 System . out. println (msg); 
17 pw = new PrintWriter(new FileWriter( 
18 "fisier.txt")); 
19 
20 for (int i = 0; i < s.length; i++) 
21 { 
22 pw.println(s[i]); 
23 } 
24 } 
25 catch (IOException ioe) 
26 { 
27 msg = "Exceptie I/O prinsa: " + ioe.getMessage(); 
28 System . out. println (msg); 
29 } 
30 finally 
31 { 
32 if (pw != null) 
33 { 
34 pw. close (); 
35 System .out.println ("Fisierul a fost inchis"); 
36 } 
37 else 
38 { 
39 System.out.printin("Fisierul nu a fost "+ 
40 "deschis"); 
4l } 
42 } 
43] 
44 ) 


Programul afişează următoarele mesaje: 


Se incearca deschiderea fisierului... 
Fisierul a fost inchis 


Totodată, programul crează un fişier numit fisier .txt, în acelaşi direc- 
tor cu fişierul sursă al aplicaţiei noastre, cu următorul conţinut: 


3 
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A> 


La o analiză atentă se observă că instrucțiunile din blocul try nu au generat 
nici o excepție (nu se afişează mesajul "Exceptie I/O prinsa: "), 
deci totul s-a executat fără eroare, iar ieşirea din blocul try nu a fost bruscă. 
Totuşi, instrucțiunile din blocul finally s-au executat pentru că a fost afişat 
mesajul "Fisierul a fost inchis". 

Să încercăm acum să înlocuim numele fişierului, fisier .txt, cu o cale 
invalidă, cum ar fi C: \test\fisier .txt, cu condiţia ca directorul test 
să NU existe pe partiția C : a hard-disk-ului dumneavoastră. Rulând programul 
astfel modificat, se obțin următoarele rezultate: 


Se incearca deschiderea fisierului... 

Exceptie I/O prinsa: c:\test\fisier.txt (The system 
cannot find the path specified) 

Fisierul nu a fost deschis 


În această situație, constructorul clasei FileWriter aruncă o excepție de 
tipul IOException, pentru că nu poate găsi directorul test, şi în consecință 
nu poate crea fişierul fisier.txt. Excepția aruncată este tratată de blocul 
catch existent, care afisează mesajul "Exceptie 1/0...", iar apoi, se 
execută din nou instrucţiunile din blocul finally, afişându-se mesajul "F i- 
sierul nu a fost deschis”. 

După cum se poate observa, blocul finally a fost executat indiferent 
dacă situaţia a fost de eroare (al doilea caz) sau nu (primul caz). Deoarece 
în blocul finally au fost eliberate resursele alocate în blocul try (în cazul 
nostru, fluxul de scriere Printwriter), putem considera blocul finally 
un mecanism elegant de a "face curăţenie” după execuţia codului din blocul 
Ey. 

Situaţia de eroare prezentată anterior nu este singulară. IOException 
pot fi generată şi dacă directorul respectiv există (deci calea este validă), dar 
aplicaţia nu are drept de scriere în acel director, sau dacă nu mai există suficient 
spaţiu pe disc pentru a scrie date în fişierul respectiv. 

Cu siguranţă că programatorii cu experienţă în alte limbaje de programare 
(în special C++, unde această noţiune nu există) se vor întreba dacă existenţa 
clauzei finally este justificată. Nevoia de a avea clauza finally devine 
evidentă dacă analizăm mai atent programul anterior, în care, fără finally, 
fluxul de scriere ar fi putut fi eliberat doar dacă am fi plasat codul în fiecare bloc 
catch separat, ceea ce ar fi dus la o duplicare inutilă a codului. 
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6.5 Aruncarea excepțiilor 


Înainte ca o excepţie să fie prinsă, trebuie să existe, undeva în cadrul claselor 
utilizate, o secvenţă de cod care să arunce excepţia respectivă. Excepţule pot fi 
aruncate atât de codul scris de dumneavoastră, cât şi codul din clase scrise de alţi 
programatori (cum ar fi, excepţiile aruncate de clasele predefinite în platforma 
Java), sau chiar de maşina virtuală JVM. Indiferent de cine aruncă excepţia, ea 
este întotdeauna aruncată folosind cuvântul cheie throw. 


6.5.1 Instrucţiunea throw 


Metodele Java aruncă excepţii folosind instrucţiunea throw . Instrucţiunea 
throw este urmată de un singur argument, care trebuie să fie o instanţă a unei 
clase derivate din clasa Throwable, şi are următoarea formă: 


throw instantaClasaDeExceptii; 


Iată câteva exemple de utilizare: 


© 
throw new Exception (); 

© 
Exception e = new Exception (); 
throw e; 

© 


// temperatura initiala a ceaiului 
int temperature = 30; 


// calcule intermediare 


// consideram ca temperatura la care ceaiul 
//nu este inca fierbinte, este de 40 de grade 
if (temperature > 40) 
{ 
// ceaiul este foarte fierbinte si nu poate fi baut, 
// deci suntem intr—o situatie de eroare, 
// motiv pentru care aruncam o exceptie 
throw new TeaTooHotException (); 
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Încercarea de a arunca drept excepţie un obiect care nu este instanţă a unei clase 
de excepţie, este semnalată drept eroare de către compilator. 

În momentul aruncării unei excepţii se realizează mai multe lucruri: mai 
întâi, se crează obiectul de tip excepţie, în acelaşi mod în care se crează orice 
obiect Java, prin folosirea cuvântului cheie new. Apoi, se întrerupe execuţia 
normală a instrucţiunilor, iar mecanismul de tratare a excepțiilor, aflat în JVM, 
preia sarcina de a căuta secvenţa de cod care tratează excepţia respectivă, pentru 
a putea continua execuţia programului. 

Crearea obiectului de tip excepţie constă de fapt în apelul unui constructor al 
clasei de excepţie. Aceasta poate avea mai multe tipuri de constructori, mai ales 
dacă respectiva clasă de excepţie este chiar o excepţie proprie, scrisă de dum- 
neavoastră (paragraful 6.3). În mod obişnuit sunt două tipuri de constructori 
care pot fi apelaţi: constructorul implicit, care nu are parametri, şi constructorul 
cu un mesaj de tip String. De exemplu: 


throw new TeaTooHotException (); 


throw new TeaTooHotException ("Ceaiul este foarte " + 
"fierbinte."); 

De obicei, se aruncă câte o clasă diferită de excepţie pentru fiecare tip de 
eroare întâlnit. Având în vedere tipurile de constructori ai clasei de excepţie, in- 
formaţia despre eroare este reprezentată atât în interiorul obiectului de excepţie 
(cu ajutorul unui mesaj String etc.), cât şi de tipul obiectului de excepţie (cu 
alte cuvinte, de numele clasei de excepţie). 

Uneori este necesar ca o anumită excepţie să fie rearuncată, adică să fie 
aruncată exact în locul în care a fost prinsă. lată un exemplu de rearuncare a 
unei excepţii: 


ı try 
2 | 


3 


a} 


s catch (Exception e) 


6 { 


7 throw e; 
8} 

Prinderea şi rearuncarea aceleiaşi excepții (ca în exemplul anterior) nu are 
nici un sens, deoarece este ca şi cum am ignora excepţia respectivă. Situaţia este 
diferită însă când tipul excepţiei prinse nu este neapărat acelaşi cu tipul excepţiei 
rearuncate. Asemenea situaţii apar frecvent în aplicaţiile ceva mai complexe 
în care o excepţie de un anumit gen este “tradusă” într-o excepţie de alt gen, 
dar cu conţinut echivalent (de exemplu, într-o aplicaţie client-server, o excepţie 
prin care serverul anunţă că nu a putut procesa o anumită cerere a clientului, 
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este tradusă de programul client într-o altă excepţie care să conţină un mesaj 
inteligibil pentru utilizator). In exemplul următor, MyNewException este o 
clasă excepţie proprie aruncată în cazul prinderii unei excepţii de intrare-ieşire: 


ı try 
2 { 


3 

4) 

s catch (IOException e) 

sl 

7 throw new MyNewException (); 


s) 


6.5.2 Clauza throws 


Orice metodă Java trebuie fie să prindă, fie să specifice clar toate excepţiile 
pe care le aruncă mai departe metodelor care o apelează. Este vorba, desigur, de 
excepţiile tratate (adică, cele care nu sunt derivate din RuntimeException, 
vezi paragraful 6.2) care pot fi aruncate de codul din interiorul metodei respec- 
tive. 

Am prezentat până acum doar cazul în care excepţiile sunt prinse şi tratate 
în cadrul aceleaşi metode, nefiind transmise mai departe. Această secţiune va 
prezenta cea de a doua posibilitate: specificarea excepțiilor care nu sunt tratate 
în cadrul metodei respective, fiind aruncate mai departe, pentru a fi prinse şi 
tratate de alte metode (cu alte cuvinte, vom învăţa cum se aruncă pisica moartă 
în ograda vecinului). 

Atunci când decidem ca o metodă să nu prindă o anumită excepţie care 
poate fi aruncată de codul din interiorul ei, trebuie să precizăm faptul că metoda 
poate arunca la rândul ei excepţia respectivă (deci vecinii trebuie avertizaţi în 
legătură cu posibilitatea de a se trezi cu o pisică decedată în ogradă). Această 
cerinţă este perfect explicabilă, pentru că specificarea excepțiilor aruncate mai 
departe de metodă ţine de interfaţa metodei, cu alte cuvinte cei care utilizează 
o metodă trebuie să cunoască precis ce excepţii aruncă chiar şi în cazul în care 
nu au la dispoziţie codul sursă al metodei, pentru a putea elabora o strategie de 
tratare a respectivelor excepţii. 

Specificarea excepțiilor aruncate de o metodă se realizează prin intermediul 
clauzei throws, utilizată în antetul metodei respective: 


itipReturnat numeMetoda (listaArgumente ) throws Exception, 


2 { 


3 


4) 
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Clauza throws se foloseşte în situaţia în care programatorul decide că nu 
este potrivit ca metoda în cauză să prindă şi să trateze o excepţie aruncată de o 
altă metodă pe care o apelează, sau dacă metoda aruncă propriile sale excepţii. 

Lista excepțiilor specificate în clauza throws cuprinde excepţiile aruncate 
direct, folosind instrucţiunea throw, precum şi excepţiile (netratate) aruncate 
de alte metode apelate. Evident, ambele tipuri de excepţii specificate în clauza 
throws, nu trebuie să fie tratate în cadrul metodei. Dacă acest lucru se întâm- 
plă, atunci excepţiile nu mai pot fi precizate în clauza throws. 

Iată un exemplu de specificare a excepțiilor care nu sunt prinse şi tratate în 
cadrul unei metode: 


public void drinkTea(int temp) throws TeaTooHotException 
{ 


l 
2 

3 // daca temperatura e prea mare 

4 if (temp > 40) 

5 { 

6 throw new TeaTooHotException (); 
A 

8 


) 
) 

Exemplul de faţă specifică faptul că metoda drinkTea() aruncă o ex- 
cepţie proprie, TeaTooHotException, dacă temperatura ceaiului este mai 
mare de 40 de grade. Datorită acestui lucru, apelul metodei drink Tea () într- 
o altă metodă se poate realiza doar dacă excepţia TeaTooHotException 
este prinsă şi tratată în cadrul acelei metode, sau dacă şi acea metodă alege să 
arunce excepţia mai departe, specificând-o în clauza throws: 


E.) 
ı public void serveCustomer() 
2 { 
3 int temperature = 45; 
4 
5 try 
6 
7 drinkTea (temperature ); 
8 } 
9 catch (TeaTooHotException exc) 
10 { 
LI ; 
12 } 
13) 
e 


ı public void serveCustomer() throws TeaTooHotException 
2 { 
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3 int temperature = 45; 


5 drinkTea(temperature); 


6} 


Este evident că în cel de-al doilea caz, excepția va trebui prinsă şi tratată la 
un moment dat, în cadrul unei metode. Deoarece este o excepție tratată, ea nu 
poate fi aruncată mai departe de fiecare metodă, fără să existe în final o metodă 
care să o prindă şi să o trateze. 


Specificarea excepțiilor aruncate de o metodă nu se poate evita, dacă metoda 
respectivă generează excepţii pe care nu le tratează, deoarece compilatorul de- 
tectează această "scăpare" şi o raportează drept eroare de compilare, propu- 
nând două soluţii: tratarea lor în cadrul metodei sau specificarea lor în clauza 
throws. 


Totuşi există o posibilitate de a "păcăli" compilatorul, atunci când se speci- 
fică faptul că o metodă aruncă o anumită excepţie, deşi acest lucru nu se întâm- 
plă. În această situaţie, compilatorul obligă apelurile metodei noastre să trateze 
excepţia sau să o specifice în clauza throws a metodei apelante, chiar dacă 
metoda noastră nu aruncă propriu-zis excepţia respectivă, ci doar pretinde că 
o aruncă. Acest lucru este util în momentul în care ştim că în viitor metoda 
noastră va fi modificată astfel încât să arunce respectiva excepţie, deoarece nu 
va mai fi necesară modificarea codului care apelează metoda, codul respectiv 
tratând excepţia în avans, înainte ca ea să fie aruncată propriu-zis de metodă. 


O ultimă observaţie: mecansimul de aruncare mai departe a excepțiilor oferă 
o modalitate deosebit de elegantă de a trata problemele care apar în decursul 
execuţiei la nivelul adecvat. De exemplu, este foarte posibil ca o metodă care 
citeşte un flux de octeți să întâlnească diverse probleme, cum ar fi: fluxul nu 
poate fi deschis, transmiterea de date s-a întrerupt prematur etc. Totuşi, metoda 
respectivă este de un nivel prea jos pentru a putea lua decizii în legătură cu 
acţiunile care trebuie întreprinse în cazul unei erori (care pot chiar diferi de la 
o situaţie la alta). Aruncând o excepţie, metoda noastră are posibilitatea de a 
anunţa metodele de nivel mai înalt care au apelat-o de faptul că secvenţa de 
execuţie nu a decurs normal, lăsând în seama acestora modul în care se tratează 
eroarea. Programatorii cu ceva experienţă în C sau Pascal vor recunoaşte proba- 
bil superioritatea acestei metode, în faţa celei în care metoda care citea dintr-un 
flux de date seta o variabilă sau returna o anumită valoare care descria modul 
în care a decurs citirea din flux (de exemplu, returna 0O dacă citirea a decurs 
normal, 1 dacă nu s-a putut deschide fişierul, 2 dacă citirea s-a întrerupt etc.). 
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6.6 Sugestii pentru utilizarea eficientă a excepții- 
lor 


Problemele cele mai mari cu care se confruntă programatorii atunci când 
utilizează excepţiile Java sunt când şi ce excepţii să arunce. 

Pentru prima problemă, răspunsul sumar pe care un programator ar putea 
să-l ofere, ar arăta astfel: 


Dacă o metodă întâlneşte o situaţie anormală pe care nu o poate 
trata, atunci metoda respectivă ar trebui să arunce o excepţie. 


Din nefericire, acest răspuns este cât se poate de ambiguu, pentru că ne conduce 
către o altă întrebare: ce înseamnă o "situaţie anormală"? Aceasta poate fi con- 
siderată întrebarea cheie a tratării excepțiilor. 

A decide dacă o anumită situaţie este anormală sau nu, rămâne însă o proble- 
mă subiectivă. Decizia nu este întotdeauna evidentă şi de aceea depinde în mare 
măsură şi de programator. Totuşi, situaţia nu este chiar atât de gravă pe cât aţi fi 
tentaţi să credeţi. Pentru a veni în ajutorul programatorilor, creatorii limbajului 
Java au considerat că o bună regulă de utilizare a excepțiilor este aceea de a 
"evita utilizarea excepțiilor pentru a indica situaţii previzibile în funcţionarea 
standard a unei metode”. 

În consecinţă, o situaţie anormală este un eveniment care nu poate fi pre- 
văzut în cazul unei funcţionări normale a metodei. Pentru o mai bună înţelegere 
a acestui concept, vom considera câteva exemple utile, în care se decide dacă 
este utilă sau nu utilizarea excepțiilor. Ca exemple am ales câteva situaţii întâl- 
nite chiar de dezvoltatorii limbajului Java la crearea ierarhiei de clase oferită de 
platforma Java, pentru a vedea cum au fost acestea tratate (dacă au fost consi- 
derate situaţii anormale şi, implicit, s-a recurs la utilizarea excepțiilor, sau dacă 
au fost considerate situaţii normale, previzibile). 

Să considerăm mai întâi cazul metodei read() a clasei FileIlnput- 
Stream, disponibilă în pachetul java.io. Această metodă returnează un 
byte citit dintr-un flux de intrare specificat. Situaţia specială cu care s-au 
confruntat dezvoltatorii limbajului Java a fost următoarea: cum ar fi trebuit să 
trateze această metodă situaţia în care toate datele din fluxul de intrare au fost 
citite, deci s-a ajuns la sfârşitul fişierului? Ar fi trebuit ca metoda read () 
să arunce o excepţie, pentru că s-a ajuns la finalul fişierului, sau, din contră, 
această situaţie să nu fie considerată specială, ci mai degrabă una previzibilă? 
Soluţia aleasă de dezvoltatorii limbajului Java a fost că metoda nu trebuie să 
arunce o excepţie, ci doar să returneze o valoare specială, —1, care să indice 
sfârşitul fişierului. Astfel, atingerea sfârşitului fişierului a fost considerată drept 
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o situaţia normală, previzibilă în utilizarea metodei read (). Motivul pentru 
care nu a fost considerată o situaţie anormală a fost acela că metoda obişnuită 
de a citi bytes dintr-un flux de intrare, este aceea de a încerca citirea lor pe 
rând, până când este atins finalul fişierului. 

Al doilea caz este cel al metodei readInt (),clasaDatalnputStrean, 
din acelaşi pachet java . io. În momentul în care este apelată, această metodă 
citeşte patru bytes din fluxul de intrare şi îi converteşte într-un int. În această 
situaţie, creatorii limbajului Java au ales ca metoda readInt () să arunce o 
excepţie, EOFExcept ion, atunci când se ajunge la sfârşitul unui fişier. Două 
au fost motivele pentru care această situaţie a fost considerată anormală: 


e metoda readiInt () nu poate returna o valoarea specială pentru a sem- 
nala sfârşitul fişierului, pentru că toate valorile pe care le-ar putea returna 
sunt valori întregi care ar putea exista în acel fişier (cu alte cuvinte, —1 
nu ar putea fi considerat sfârşitul fişierului, pentru că ar putea exista un 
element -1 în cadrul fişierului, şi astfel am fi induşi în eroare, deoarece 
prezenţa elementului -1 în cadrul acelui fişier nu înseamnă obligatoriu 
că fişierul a fost parcurs până la final); 


e metoda readiInt () poate fi pusă în ipostaza de a putea citi doar unul, 
doi sau trei bytes din fluxul de intrare, şi nu patru, cât îi este necesar 
pentru a forma un int (o variabilă de tip întreg este reprezentată în Java 
pe 4 octeți), ceea ce poate fi considerată o situaţie anormală. Datorită 
acestui fapt, excepţia EOFExcept ion este definită ca o excepţie tratată, 
motiv pentru care programatorii care utilizează metoda readInt () sunt 
obligaţi să prindă această excepţie şi să o trateze. 


Al treilea exemplu se referă la interfaţa java.util.Enumeration, îm- 
preună cu cele două metode ale sale, hasMoreElements () şi nextEle- 
ment (). Această interfaţă reprezintă o modalitate de a parcurge o serie de ele- 
mente, câte unul pe rând, de la primul element până la ultimul element al seriei. 
Obţinerea unui element din serie se face cu ajutorul metodei nextElement (), 
care returnează elementul curent din serie şi mută poziţia cursorului pe urmă- 
torul element, care astfel devine noul element curent. Metoda hasMoreEle- 
ments () returnează o valoare booleană, care indică dacă seria a fost parcursă 
în întregime sau nu s-a atins încă sfârşitul ei. Metoda hasMoreElements () 
trebuie să fie apelată de fiecare dată înaintea metodei nextElement () pentru 
a vedea dacă s-a ajuns la sfârşitul seriei de elemente sau nu. Această abordare ne 
arată că dezvoltatorii limbajului Java nu au considerat atingerea sfârşitului seriei 
de elemente ca fiind o situaţie anormală, ci una previzibilă. Totuşi, dacă sfârşi- 
tul seriei a fost atins şi este apelată metoda nextElement (), fără a apela 
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metoda hasMoreElements () în prealabil, atunci este aruncată o excepţie, 
NoSuchElementExcept ion, care reprezintă o excepţie netratată (subclasă 
a clasei RuntimeException), aruncată mai degrabă pentru a indica o eroare 
de programare (faptul că interfaţa nu este utilizată corect), decât pentru a indica 
sfârşitul seriei de elemente. 

După cum se poate observa, regula general valabilă este că în cazul în care 
situaţia este previzibilă (de exemplu, sfârşitul unui fişier, al unei serii de elemen- 
te, sau obţinerea unui rezultat nul la operaţia de căutare a unui element într-un 
şir de elemente), nu este recomandată utilizarea excepțiilor. 

O altă abordare a problemei utilizării eficiente a excepțiilor este legată de 
modul în care metodele sunt utilizate. Să luăm cazul metodei chartaAt () 
a clasei String, din pachetul java.lang. Această metodă primeşte ca 
parametru un întreg şi returnează caracterul din string aflat pe poziţia indicată 
de parametru. 

Dacă metoda charat () este apelată cu parametrul —1 sau un întreg de o 
valoare mai mare decât lungimea şirului, ea nu îşi poate executa sarcina pentru 
că datele sale de intrare sunt incorecte. Iar, dacă datele de intrare sunt incorecte, 
nici cele de ieşire (rezultatele) nu pot fi corecte. De aceea, metoda aruncă o ex- 
cepţie StringIndex0utOfBoundsException,care indică faptul că pro- 
gramatorul are o eroare de programare sau nu a utilizat clasa corect. 

Pe de altă parte, dacă datele de intrare sunt corecte, dar dintr-un anumit mo- 
tiv chartaAt () nu ar putea returna caracterul de pe poziţia specificată, atunci 
metoda ar trebui să semnaleze acest lucru aruncând o excepţie, prin care indică 
faptul că sunt probleme care necesită o tratare specifică. 

Prin intermediul acestei abordări se poate trage concluzia că excepţiile tre- 
buie utilizate atunci când metodele nu beneficiază de date de intrare corecte 
(precondiţie încălcată) sau când, deşi au date de intrare corecte, totuşi, din anu- 
mite motive, nu îşi pot duce la bun sfârşit execuţia (postcondiţie încălcată). 

Cea de a doua problemă majoră cu care se confruntă programatorii Java este 
ce excepţii să arunce. 

După ce s-a decis utilizarea excepțiilor, următorul pas este să decidem ce 
tipuri de excepţii să utilizăm. Avem de ales între a arunca excepţii instanţe ale 
clasei Throwable sau ale unei subclase a acesteia. Pe de altă parte, se pot 
arunca excepţii predefinite de platforma Java (existente în Java API), sau putem 
crea propria ierarhie de excepţii. 

Prima sugestie în alegerea tipului de excepţii este aceea de a arunca în- 
totdeauna excepții (subclase ale clasei Exception) şi nu erori (subclase ale 
clasei Error). Motivul este că Error are scopul de a semnala probleme com- 
plexe, delicate ale sistemului unde este preferabil să nu ne băgăm nasul. 

A doua sugestie este legată de modul de utilizare a excepțiilor tratate (checked 
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exceptions) şi a celor netratate (unchecked exceptions). După cum s-a obser- 
vat de-a lungul acestui capitol, aruncarea în cadrul unei metode a unei excepţii 
tratate, forţează codul care apelează metoda respectivă să trateze acea excepţie. 
Pe de altă parte, aruncarea în cadrul unei metode a unei excepţii netratate (ex- 
cepţii runtime), nu obligă codul care apelează metoda respectivă să trateze acea 
excepţie, lăsând la latitudinea programatorului decizia de a prinde sau nu ex- 
cepţia respectivă. 


Sugestia în această situaţie este că, dacă sunteţi de părere că excepţia tre- 
buie obligatoriu tratată de utilizatorul codului dumneavoastră, atunci aruncaţi 
excepţii tratate. 


În general, excepţiile care indică o utilizare improprie a metodelor unei 
clase (o eroare de programare) sunt excepţii netratate. Un exemplu potrivit 
este cel anterior, în care metoda charAt () aruncă excepţia StringIndex- 
OutOfBoundsException. Dacă metoda chart () este apelată cu argu- 
mentul —1, ea aruncă o excepţie prin care semnalează că nu a fost utilizată 
corect (nu există indicele —1 într-un şir de elemente). Pe de altă parte, ex- 
emplul metodei readInt () din clasa DatalnputStrean şi al excepţiei 
EOFExcept ion este util pentru a ilustra alegerea excepțiilor tratate. Deoarece 
excepţia EOFException indică o eroare care a survenit în momentul citirii 
din fişier, nu poate fi vorba de o utilizare greşită a clasei DatalnputStream. 
Excepţia semnalează că, deşi clasa a fost utilizată corect, totuşi metoda nu a 
reuşit să îşi îndeplinească funcţionalitatea, ceea ce reprezintă o situaţie anor- 
mală, motiv pentru care programatorii care utilizează această metodă sunt obli- 
gaţi să trateze cazul de excepţie. 


Cea de-a treia şi ultima sugestie este aceea de a înlocui clasele de excepţii 
predefinite de platforma Java cu propriile clase de excepţii, atunci când consi- 
deraţi că ar fi mai explicit astfel. Puteţi realiza acest lucru dacă prindeţi excepţia 
predefinită Java, şi, în codul de tratare a excepţiei respective, aruncaţi propria 
dumneavoastră excepţie. 


Utilizarea excepțiilor îşi are propriul ei preţ din punct de vedere al resurselor 
utilizate. Datorită stivei de apel (call stack), creată de maşina virtuală JVM pen- 
tru a reţine ordinea în care metodele au fost apelate, oprirea bruscă din execuţie 
a unei metode (în caz de excepţie) este mult mai costisitoare decât o execuţie 
fără incidente a metodei respective, deoarece maşina virtuală consumă resurse 
căutând în stiva de apel, metoda care conţine secvenţa de cod ce tratează res- 
pectiva excepţie. Din acest motiv, excepţiile trebuie utilizate ponderat, mai ales 
în metodele care se apelează foarte frecvent şi a căror viteză de execuţie este 
esenţială. 
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Existenţa unui mecanism de tratare a erorilor este una dintre principalele 
modalităţi de a creşte robusteţea unei aplicaţii. Tratarea erorilor este un prin- 
cipiu fundamental pentru orice aplicaţie, în special în Java, unde un ţel foarte 
important este acela de a crea componente de aplicaţii care vor fi utilizate de alți 
programatori. Pentru a asigura dezvoltarea unei aplicaţii profesionale, fiecare 
dintre aceste componente trebuie să fie robustă. 

Excepţiile oferă multe avantaje programatorilor. În primul rând, ele separă 
codul care tratează erorile de codul care funcţionează normal. Codul suspect de 
a se executa cu eroare (chiar dacă această eroare poate apare doar în 0, 0015 
din cazuri) este încadrat într-un bloc try pentru a fi ţinut sub observaţie. Chiar 
dacă utilizarea excepțiilor vă poate ajuta să faceţi codul mai lizibil, prin sepa- 
rarea codului de tratare a erorilor de cel normal, totuşi, utilizarea inadecvată a 
lor produce un cod dificil de citit şi înţeles. Pe de altă parte, mecanismul Java 
de tratare a erorilor permite propagarea erorii, prin aruncarea mai departe a ero- 
rilor prinse, obligând altă metodă să le trateze. Nu în ultimul rând, verificarea 
de către compilator a existenţei codului de tratare a unei excepţii tratate, este un 
prim pas spre a avea un cod stabil şi robust. 

Din aceste motive este indicat ca pentru fiecare aplicaţie să se dezvolte o 
strategie de tratare a excepțiilor. De asemenea, excepţiile nu trebuie să fie con- 
siderate ca un adaos la o aplicaţie, ci ca o parte integrantă a acesteia, iar pentru a 
realiza acest lucru este necesar ca strategia de tratare a excepțiilor să fie adoptată 
în timpul fazei de proiectare a aplicaţiei, şi nu în faza de implementare. 


Rezumat 


Capitolul de faţă a prezentat modalitatea în care Java tratează situaţiile de 
excepţie în cadrul unei aplicaţii. 

Excepţiile sunt folosite pentru a semnala situaţii de eroare. O excepţie este 
generată de clauza throw şi se propagă până este prinsă şi tratată de un bloc 
catch, asociat cu un bloc try. Pe de altă parte, metodele specifică în cadrul 
unei liste throws excepţiile tratate pe care le aruncă. 

Capitolul următor prezintă pe scurt sistemul de intrare/ieşire în limbajul 
Java. 


Noţiuni fundamentale 


catch: bloc de instrucţiuni utilizat pentru tratarea unei excepţii. 
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excepţie runtime: excepţie netratată, care nu necesită să fie prinsă şi tratată 
(ex. NullPointertxception, IndexO0utOfBoundsException). 

excepţie tratată: excepţie care trebuie prinsă sau propagată explicit într-o 
clauză throws. 

finally: bloc de instrucţiuni care se execută indiferent de rezultatul exe- 
cuţiei blocului try-catch. 

NullPointerException: tip de excepţie generată de încercarea de a 
apela un atribut sau o metodă pe o referinţă nul. 

throw: instrucţiune utilizată pentru a arunca o excepţie. 

throws: indică faptul că o metodă poate propaga o excepţie. 

try: cuprinde codul suspect, care ar putea genera o excepţie. 


Erori frecvente 


1. Excepţiile tratate trebuie să fie în mod obligatoriu prinse sau propagate în 
mod explicit prin intermediul clauzei throws. 


2. Deşi este tentant (de dragul simplităţii) să scriem clauze catch vide, 
aceasta face ca programul să fie foarte dificil de depanat, deoarece ex- 
cepţiile sunt prinse fără a se semnala deloc acest lucru. 


Exerciţii 
Pe scurt 


1. Descrieţi mecanismul de funcţionare a excepțiilor în limbajul Java. 


2. Care excepţii trebuie tratate obligatoriu şi care nu? 
În practică 


1. Creați o metodă main () care aruncă un obiect de tip Exception în in- 
teriorul unui bloc try. Furnizaţi constructorului obiectului Exception 
un mesaj de tip String. Prindeţi excepţia în cadrul unei clauze catch 
şi afişaţi mesajul de tip String. Adăugaţi o clauză finally în care să 
tipăriţi un mesaj pentru a verifica faptul că aţi trecut pe acolo. 


2. Creați o clasă proprie de excepţii, asemănătoare lui TeaTooHotExcep- 
tion din paragraful 6.3. Adăugaţi clasei un constuctor cu un parametru 
de tip String care reţine parametrul într-un atribut al clasei. Scrieţi 


205 


6.7. AVANTAJELE UTILIZĂRII EXCEPŢIILOR. CONCLUZII 


o metodă care afişează String-ul stocat. Exersaţi noua clasă creată 
folosind un bloc try-catch. 


3. Scrieţi o clasă cu o metodă care să arunce o excepţie de tipul celei de- 
scrise la exerciţiul anterior. Încercaţi să o compilaţi fără a preciza ex- 
cepţia în clauza throws. Adăugaţi apoi clauza throws adecvată şi 
apelaţi metoda în cadrul unei clauze try-catch. 


4. Declaraţi o referinţă şi iniţializaţi-o cu null. Apelaţi apoi o metodă pe 
referinţa respectivă, pentru a verifica faptul că veţi obţine Nul 1Pointer- 
Exception. Încadraţi apoi apelul într-un bloc try-catch pentru a 
prinde excepţia. 


5. Scrieţi o secvenţă de cod care să genereze şi să prindă o excepţie de 
tipul ArrayIndexO0utOfBoundsException sau de tipul String- 
IndexO0utOfBoundsException. 


6. Definiţi o clasă cu două metode, f () şig(). În metoda f () aruncaţi 
o excepţie de un tip definit de dumneavoastră. În metoda g() apelaţi 
metoda f (), prindeţi excepţia aruncată de f () şi aruncaţi mai departe o 
excepţie de tip diferit. Testaţi codul în metoda main () a clasei. 


7. Definiţi o metodă care aruncă (în clauza throws) mai multe tipuri de 
excepţii definite de dumneavoastră. Apelaţi apoi metoda şi prindeţi toate 
excepţiile aruncate folosind o singură clauză catch. Modificaţi apoi 
programul astfel încât clauza catch să prindă doar aceste tipuri de ex- 
cepţii. 


8. Pentru exemplul cu clasa Shape din capitolul anterior, modificaţi meto- 
dele readShape () şi main () astfel încât ele să arunce şi să prindă 
excepţii (în loc să creeze un cerc de rază 0) atunci când se observă o 
eroare la citire. 


9. În multe situaţii o metodă care aruncă o excepţie este reapelată până când 
execuţia ei decurge normal sau s-a atins un număr maxim de încercări. 
Creați un exemplu care să simuleze acest comportament, prin apelarea 
unei metode în cadrul unui ciclu while, care ciclează până când nu se 
mai aruncă nici o excepţie. 
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“Poţi să îmi spui, te rog, pe unde 
să ies de aici?” 

“Aceasta depinde în mare măsură 
de unde vrei să mergi”, spuse 
pisica. 

“Nu prea îmi pasă unde...”, spuse 
Alice. 

“Atunci nu contează pe ce drum 
ieşi”, spuse pisica. 


Lewis Caroll, Alice în ţara 
minunilor 


În capitolul anterior am prezentat excepţiile Java şi modalitatea în care se 
tratează situaţiile de eroare apărute în cadrul unei aplicaţii. În capitolul de faţă 
vom parcurge pe scurt sistemul Java de intrare-ieşire. 

Vom afla detalii despre: 


e Cum este structurat sistemul Java de intrare şi ieşire (I/O); 
e Care sunt modalităţile de a citi/scrie date într-o aplicaţie Java; 


e Cum sunt utilizate pachetele de resurse pentru a simplifica citirea datelor 
de intrare într-un program Java. 


7.1 Preliminarii 


Intrarea şi ieşirea în Java se realizează cu ajutorul claselor din pachetul pre- 
definit java.io. Din acest motiv, orice program care foloseşte rutinele de 
intrare/ieşire trebuie să cuprindă instrucţiunea: 
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import java.io.x; 


Biblioteca Java de intrare/ieşire este extrem de sofisticată şi are un număr 
foarte mare de opţiuni. În cadrul acestui capitol vom examina doar elementele 
de bază referitoare la intrare şi ieşire, concentrându-ne în întregime asupra ope- 
raţiilor de intrare-ieşire formatate (nu vom vorbi despre operaţii de intrare-ieşire 
binare). 

Deşi în practică programele Java îşi preiau datele de intrare din fişiere sau 
chiar prin Internet, pentru cei care învaţă acest limbaj este uneori mai convenabil 
să preia datele de la tastatură, aşa cum obişnuiau în C sau Pascal. Vom arăta în 
paragrafele care urmează cum se pot prelua datele de la tastatură şi cât de puţine 
modificări sunt necesare pentru a prelua aceleaşi date din fişiere. 


7.2 Operații de bază pe fluxuri (stream-uri) 
Java oferă trei fluxuri predefinite pentru operaţii I/O standard: 


e System.in (intrarea standard); 
e System.out (ieşirea standard); 


e System.err (fluxul de erori). 


Aşa cum am arătat deja, metodele print şi println sunt folosite pentru 
afişarea formatată. Orice fel de obiect poate fi convertit la o formă tipăribilă, 
folosind metoda toString (); în multe cazuri, acest lucru este realizat au- 
tomat. Spre deosebire de C şi C++ care dispun de un număr enorm de opţiuni 
de formatare, afişarea în Java se face exclusiv prin concatenare de String-uri, 
fără nici o formatare. 

O modalitate simplă de a realiza citirea este aceea de a citi o singură linie 
într-un obiect de tip String folosind metoda readLline (). readLine() 
preia caractere de la intrare până când întâlneşte un terminator de linie sau 
sfârşit de fişier. Metoda returnează caracterele citite (din care extrage termina- 
torul de linie) ca un String nou construit. Pentru a citi date de la tastatură 
folosind readLine () trebuie să construim un obiect BufferedReader 
dintr-un obiect InputStreamReader care la rândul său este construit din 
System.in. Acest lucru a fost ilustrat în capitolul 3, Listing 3.2. 

Dacă primul caracter citit este EOF, atunci metoda readLine () returnează 
null, iar dacă apare o eroare la citire, se generează o excepţie de tipul IOEx- 
ception. În cazul în care şirul citit nu poate fi convertit la o valoare întreagă, 
se generează o excepţie NumberFormatException. 
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7.3 Obiectul StringTokenizer 


Obiectul StringTokenizer ne permite să separăm elementele lexicale 
distincte din cadrul unui string. Să ne reamintim că pentru a citi o valoare 
primitivă, cum ar fi int, foloseam readLline () pentru a prelua linia ca pe 
un String şi apoi aplicam metoda parseInt () pentru a converti stringul la 
tipul primitiv. 

În multe situaţii avem mai multe elemente pe aceeaşi linie. Să presupunem, 
de exemplu, că fiecare linie are două valori întregi. Putem accesa fiecare din- 
tre aceste două valori, utilizând clasa StringTokenizer pentru a separa 
String-ul în elemente lexicale (engl. token). Pentru a putea folosi obiecte ale 
clasei StringTokenizer se foloseşte directiva: 


import java.util. StringTokenizer; 


Folosirea obiectului StringTolenizer este exemplificată în programul 
din Listing 7.1. Obiectul StringTokenizer este construit în linia 19 prin 
furnizarea obiectului Str ing reprezentând linia citită. Apelul metodei count- 
Tokens () din linia 20 ne va da numărul de cuvinte citite (elemente lexicale). 
Metoda nextToken () întoarce următorul cuvânt necitit ca pe un String. 
Această ultimă metodă generează o excepţie NoSuchElementException 
dacă nu există nici un cuvânt rămas, dar aceasta este o excepţie de execuţie stan- 
dard şi nu trebuie neapărat prinsă. La liniile 26 şi 27 folosim next Token () 
urmată de parseInt () pentru a obţine un int. Toate erorile sunt prinse în 
blocul catch. 

Implicit, Java consideră spaţiul, caracterul tab sau linia nouă drept delimi- 
tator al elementelor lexicale, dar obiectele de tip StringTokenizer pot fi 
construite şi în aşa fel încât să recunoască şi alte caractere drept delimitatori. 


Listing 7.1: Program demonstrativ pentru clasa StringTokenizer 


1//program pentru exemplificarea clasei 

2 //StringTokenizer. Programul citeste doua numere aflate pe 
3 //aceeasi linie si calculeaza maximul lor 

4 

s import java.io.* ; 

simport java.util.x ; 

7 

s public class TokenizerTest 

9 

{ 


o public static void main(String [] args) 


12 BufferedReader in = new BufferedReader ( 
13 new InputStreamReader(System.in)); 
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15 System .out.println ("Introduceti 2 nr. pe linie:"); 
16 try 

17 { 

18 String s = in.readLine (); 

19 StringTokenizer st = new StringTokenizer (s); 
20 if (st.countTokens () != 2) 

21 { 

22 System . out. println ("Numar invalid de " + 
23 "argumente!" ); 

24 return ; 

25 ) 

26 int x = Integer. parselnt(st.nextToken ()); 

27 int y = Integer.parselnt(st.nextToken ()); 

28 System . out. println ("Maximul este: " + 

29 Math.max(x, y)); 

30 ) 

31 catch (Exception e) 

32 { 

33 System . out. println (e); 


7.4 Fişiere secvențiale 


Una dintre regulile fundamentale în Java este aceea că ceea ce se poate face 
pentru operații 1/O de la terminal se poate face şi pentru operații I/O din fişiere. 
Pentru a lucra cu fişiere, obiectul BufferedReader nu se construieşte pe 
baza unui InputStreamReader. Vom folosi în schimb un obiect de tip 
FileReader care va fi construit pe baza unui nume de fişier. 

Un exemplu pentru ilustrarea acestor idei este prezentat în Listing 7.2. 
Acest program listează conţinutul fişierelor text care sunt precizate ca parametri 
în linie de comandă. Funcţia main () parcurge pur şi simplu argumentele din 
linia de comandă, apelând metoda listFile() pentru fiecare argument. În 
metoda listFile () construim obiectul de tip FileReader la linia 26 şi 
apoi îl folosim pe acesta pentru construirea obiectului de tip Buf feredReader 
în linia următoare. Din acest moment, citirea este identică cu cea de la tastatură. 

După ce am încheiat citirea din fişier, trebuie să închidem fişierul, altfel s-ar 
putea să nu mai putem deschide alte stream-uri (să atingem limita maximă de 
stream-uri care pot fi deschise). Nu este indicat să facem acest lucru în primul 
bloc try, deoarece o excepţie ar putea genera părăsirea prematură a blocului 
şi fişierul nu ar fi închis. Din acest motiv, fişierul este închis după secvenţa 
try/catch. 
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Scrierea formatată în fişiere este similară cu citirea formatată. 


Listing 7.2: Program care listează conţinutul unui fişier 


//program pentru afisarea continutului fisierelor 
//ale caror nume sunt precizate in linia de comanda 
import java.io.x* ; 


public class Lister 


{ 


public static void main(String [] args) 


{ 


) 


if (args.length == 0) 


{ 
System .out.println ("Nici un fisier precizat!" ); 
) 
for (int i =0; i < args.length; ++i) 
{ 
listFile(argsl[i]); 
) 


public static void listFile(String fileName) 


{ 


System . out. println ("NUME FISIER: " + fileName); 


try 


{ 


FileReader file = new FileReader (fileName ); 
BufferedReader in = new BufferedReader (file ); 


String s; 
while ((s = in.readLine()) != null) 
{ 
System . out. println (s); 
) 
catch (Exception e) 
{ 
System . out. println (e); 
) 
try 


if (in != null) 


{ 


in.close (); 


) 


catch (IOException e) 
{ // ignora exceptia 


) 
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7.5 Utilizarea colecţiilor de resurse (resource bun- 
dles) 


Vom prezenta acum şi o altă modalitate de a stoca şi accesa date, în care 
se foloseşte o structurare a datelor la un nivel superior: colecţiile de resurse 
(resource bundles). 

Scopul pentru care colecţiile de resurse au fost implementate de creatorii 
limbajului Java, nu a fost acela de a le folosi pentru citirea de date, ci pentru 
a realiza internaţionalizarea aplicaţiilor, cu alte cuvinte pentru a permite tra- 
ducerea interfeţei unei aplicaţii dintr-o limbă în alta, într-un mod foarte simplu. 
Utilizarea lor a fost însă extinsă de programatori şi pentru a stoca şi citi date într- 
un format mai organizat, superior orientării pe octeți a fluxurilor de date. Vom 
prezenta în continuare un exemplu simplu de utilizare a colecţiilor de resurse 
pentru a extrage informaţii dintr-un fişier de proprietăţi. Anexa D prezintă în 
detaliu modul în care se utilizează colecţiile de resurse şi în alte direcţii. 


7.5.1 Utilizarea fişierelor de proprietăţi pentru citirea datelor 


Colecţiile de resurse pot fi reprezentate sub mai multe forme în Java. Anexa 
D vă stă la dispoziţie pentru lămuriri în această privinţă. Ca exemplu, am 
ales pentru reprezentarea colecţiilor de resurse varianta fişierelor de proprietăți. 
Fişierele de proprietăţi sunt simple fişiere text, cu extensia .properties. 
lată un exemplu: 


+fisierul de proprietati pentru programul Human.java 
age=14 
height=1.70 


După cum se poate observa, fişierul de proprietăţi este format din perechi 
de tipul cheie/valoare. Cheia este de partea stângă a semnului egal, iar valoarea 
este de partea dreaptă. De exemplu, age este cheia care corespunde valorii 14. 
Analog, putem spune că 14 este valoarea care corespunde cheii age. Cheia 
este arbitrară. Am fi putut denumi cheia age altfel, de exemplu myAge sau a. 
Odată definită însă, cheia nu trebuie schimbată pentru că ea este referită în codul 
sursă. Pe de altă parte, valoarea asociată cheii poate fi schimbată fără probleme. 
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De asemenea, se remarcă faptul că semnul + este folosit pentru comentarea unei 
linii din cadrul fişierului de proprietăţi. 

Să considerăm că fişierul de proprietăţi prezentat mai sus este salvat pe disc 
în fişierul cu numele humanProp.properties. Evident, puteţi schimba 
acest nume cu unul la alegerea dumneavoastră. Programul Java din Listing 
7.3 prezintă o modalitate de utilizare a acestui pachet de resurse (pentru o ex- 
ecuţie corectă, salvaţi acest fişier cu numele Human . java în acelaşi director 
cu fişierul humanProp.properties). 


Listing 7.3: Program de test pentru fişiere de proprietăţi 


ı import java.util.x; 
2 
3 public class Human 


5 public static void main(String args []) 

6 { 

7 try 

8 { 

9 ResourceBundle rb = ResourceBundle. getBundle( 
10 "humanProp"); 

11 

12 String sl = rb. getString("age"); 

13 System . out. println (sl); 

14 

15 String s2 = rb.getString("height"); 

16 System . out. println (s2); 

17 } 

18 catch (Exception e) 

19 { 

20 System . out. println ("EXCEPTION: " + e.getMessage()); 


21 } 


Utilizarea fişierelor de proprietăți este, după cum se vede şi în exemplul 
precendent, destul de simplă. Metoda getBundle () realizează accesul la 
fişierul humanProp.properties. Se observă faptul că nu este necesară 
extensia .properties în apelul metodei. 

Accesul la valorile cheilor se face prin metoda getString(). Trebuie 
reţinut faptul că toate valorile care sunt preluate din fişierele properties 
sunt de tipul String. De aceea, ele trebuie convertite către tipurile lor. În cazul 
nostru, valoarea cheii age trebuie convertită la int, iar cea a cheii height 
la float sau double. Pentru a păstra simplitatea programului, am ales să 
nu mai convertim aceste valori, ci doar le afişăm pentru a testa valoarea lor. 
Rezultatul afişării este: 
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14 
Ler 


Această modalitate de organizare şi citire a datelor este deosebit de utilă 
pentru a păstra date a căror organizare logică este de forma cheie=valoare, cum 
ar fi de exemplu stocarea opțiunilor utilizatorului unei aplicații. În cazul unui 
editor de texte scris în Java, fişierul de proprietăți ar putea stoca preferințele 
utilizatorului referitoare la dimensiunea fontului, culori, directorul de pornire 
etc. 


Rezumat 


Ceea ce am prezentat în acest capitol a constituit o prezentare sumară, dar 
suficientă pentru a putea merge mai departe, a sistemului de intrare-ieşire ex- 
istent în Java. Au fost prezentate fluxurile de intrare/ieşire, clasa StringTo- 
kenizer, fişierele secvențiale şi colecţiile de resurse. Deşi introduse pentru a 
permite internaţionalizarea aplicaţiilor (vezi anexa dedicată acestei probleme), 
am văzut cum pot fi utilizate colecţiile de resurse pentru a prelua date din fişiere 
de proprietăţi. 


Noţiuni fundamentale 


argument în linie de comandă: parametru scris în linia de comandă în care 
se realizează execuţia programului respectiv. Acest parametru poate fi folosit în 
cadrul funcţiei main a aplicaţiei rulate. 

BufferedReader: clasă Java predefinită utilizată pentru citirea pe linii 
separate a datelor de intrare. 

colecţie de resurse: mulţime de proprietăţi care au asociate anumite valori. 
Cunoscută şi sub numele de pachet de resurse. 

FileReader: clasă utilizată pentru lucrul cu fişiere. 

fişiere de proprietăţi: fişiere text având extensia .properties, cu un 
conţinut special, format din perechi de tipul proprietate=valoare, sto- 
cate câte una pe linie. 

StringTokenizer: clasă utilizată pentru a delimita cuvintele existente 
în cadrul unei propoziţii. Cuvintele sunt despărțite prin separatori. 

System.out, System.in, System.err: fluxurile standard de ie- 
şire, intrare, eroare pentru operaţii de citire-scriere. 
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Erori frecvente 


1. Fişierele de proprietăţi trebuie să aibă extensia .properties. 


Exerciţii 


1. Scrieţi un program care afişează numărul de caractere, cuvinte, linii pen- 
tru fişiere precizate în linie de comandă. 


2. Implementaţi un program care realizează copierea unui fişier dintr-o lo- 
caţie în alta. 
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Timpul este modalitatea prin care 
natura are grijă să nu se producă 
totul simultan. 


Autor anonim 


Programarea concurentă reprezintă pentru mulţi programatori Java un con- 
cept neobişnuit, care necesită timp pentru a fi asimilat. Efortul necesar pen- 
tru tranziţia de la programarea neconcurentă la programarea concurentă este 
asemănător cu cel pentru tranziţia de la programarea procedurală la progra- 
marea orientată pe obiecte: o tranziţie dificilă, frustrantă uneori, dar, în final, 
efortul este recompensat pe deplin. Dacă la prima parcurgere nu înţelegeţi a- 
numite secvenţe din acest capitol, pentru a vă uşura sufletul daţi vina pe slaba 
inspiraţie a autorilor, lăsaţi ceva timp pentru ca informaţiile să se asimileze şi 
încercaţi să rulaţi exemplele, după care reluaţi secvenţa care v-a creat dificultăţi. 

În acest capitol vom prezenta: 


e Ce este un fir de execuţie; 
e Cum se creează aplicaţii care rulează pe mai mult fire de execuţie; 


e Cum se evită inconsistenţa la concurenţă folosind metode sincronizate şi 
instrucţiunea synchronized; 


e Cum funcţionează monitoarele în Java; 


e Cum se coordonează firele de execuţie folosind metodele wait () şi no- 
el i 28 6 (0 a 
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8.1 Ce este un fir de execuţie? 


Firele de execuţie (engl. threads) permit unui program să execute mai multe 
părți din el însuşi în acelaşi timp. De exemplu, o parte a programului poate să 
realizeze o conexiune la un server de internet şi să descarce nişte date, în timp 
ce cealaltă parte a programului afişează fereastra principală şi meniul aplicaţiei 
pentru a putea interacţiona în acest timp cu utilizatorul. Un alt exemplu clasic 
de utilizare a firelor de execuţie îl constituie un browser de Web care vă per- 
mite să descărcaţi un număr nedefinit de fişiere (fiecare operaţie de descărcare 
reprezintă un fir de execuţie), timp în care puteţi să navigaţi nestingheriţi prin 
alte pagini (pe un alt fir de execuţie). 

Firele de execuţie sunt o invenţie relativ recentă în lumea informaticii, deşi 
procesele, surorile lor mai mari, sunt folosite deja de câteva decenii. Firele de 
execuţie sunt asemănătoare cu procesele, în sensul că pot fi executate indepen- 
dent şi simultan, dar diferă prin faptul că nu implică un consum de resurse atât 
de mare. Cei care aţi programat în C sau C++ vă amintiţi probabil faptul că 
prin comanda fork se putea crea un nou proces. Un proces astfel creat este o 
copie exactă a procesului original, având aceleaşi variabile, cod etc. Copierea 
tuturor acestor date face ca această comandă să fie costisitoare ca timp de ex- 
ecuţie şi resurse folosite. În timp ce rulează, procesele generate prin fork sunt 
complet independente de procesul care le-a creat, ele putându-şi chiar modifica 
variabilele fără a afecta procesul părinte. 

Spre deosebire de procese, firele de execuţie nu fac o copie a întregului 
proces părinte, ci pur şi simplu rulează o altă secvenţă de cod în acelaşi timp. 
Aceasta înseamnă că firele de execuţie pot fi pornite rapid, deoarece ele nu 
necesită copierea de date de la procesul părinte. În consecinţă, firele de execuţie 
vor partaja între ele datele procesului căruia îi aparţin. Ele vor putea scrie sau 
citi variabile pe care oricare alt fir de execuţie le poate accesa. Din acest motiv, 
comunicarea între firele de execuţie este mai facilă, dar poate conduce şi la 
situaţia în care mai multe fire de execuţie modifică aceleaşi date în acelaşi timp, 
conferind rezultate imprevizibile. 

Firele de execuţie permit o mai bună utilizare a resurselor calculatorului. 
În situaţia în care maşina virtuală Java (JVM) rulează pe un sistem multiproce- 
sor, firele de execuţie din cadrul aplicaţiei pot să ruleze pe procesoare diferite, 
realizând astfel un paralelism real. Am arătat deja că există avantaje efective 
ale utilizării firelor de execuţie şi pe sistemele cu un singur procesor. Folosirea 
lor permite scrierea de programe mai simple şi mai uşor de înţeles. Un fir de 
execuţie poate să execute o secvenţă de cod care realizează o operaţie simplă, 
lăsând restul muncii altor fire de execuţie. 

În rezumat, putem spune că un proces este un program de sine stătător, care 
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dispune de propriul lui spaţiu de adrese. Un sistem de operare multitasking 
este capabil să ruleze mai multe procese (programe) în acelaşi timp, oferindu-le 
periodic un anumit număr de cicluri procesor, lăsând astfel impresia că fiecare 
proces se execută de unul singur. Un fir de execuţie (thread) reprezintă un singur 
flux de execuţie din cadrul procesului. Astfel, un singur proces poate să conţină 
mai multe fire de execuţie care se execută în mod concurent. 


8.2 Fire de execuţie în Java 


Specificaţiile limbajului Java definesc firele de execuţie (thread-urile) ca 
făcând parte din bibliotecile Java standard (pachetele java. *). Fiecare im- 
plementare a limbajului Java trebuie să furnizeze bibliotecile standard, deci im- 
plicit să suporte şi fire de execuţie. În consecinţă, cei care dezvoltă aplicaţii 
Java pot întotdeauna să se bazeze pe faptul că firele de execuţie vor fi prezente 
pe orice platformă va rula programul. Mai mult, toate bibliotecile standard Java 
fie sunt thread-safe (adică sunt fiabile în cazul utilizării lor simultane de către 
mai multe fire de execuţie) sau, dacă nu, au măcar un comportament bine definit 
în această situaţie. De exemplu, se ştie că clasa Vector este thread-safe, deci 
elementele dintr-un vector pot fi modificate de către mai multe fire de execuţie 
simultan, fără a se pierde consistenţa datelor. Clasa ArrayList este echiva- 
lentul clasei Vector care nu este thread-safe, dar are avantajul de a fi mai 
rapidă. 


8.2.1 Crearea firelor de execuţie 


În Java există două variante pentru a crea fire de execuţie: fie se derivează 
din clasa Thread, fie se implementează interfaţa Runnable. Ambele variante 
conduc la acelaşi rezultat. Dacă se implementează interfaţa Runnable, putem 
converti clase deja existente la fire de execuţie fără a fi nevoie să modificăm 
clasele din care acestea sunt derivate (acesta este practic singurul avantaj adus 
de implementarea interfeţei Runnable). 


Derivarea din clasa Thread 


Cea mai simplă modalitate de a crea un fir de execuţie este să extindem clasa 
Thread, care conţine tot codul necesar pentru a crea şi rula fire de execuţie. 
Cea mai importantă metodă pentru clasa Thread este run (). Prin redefinirea 
acestei metode se precizează instrucţiunile care trebuie executate de firul de 
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Listing 8.1: Exemplu simplu de fire de execuţie create prin derivarea din clasa 
Thread 


1 public class SimpleThread extends Thread 


2 { 

3 private int countDown = 5; 

4 private static int threadCount = Q; 

5 private int threadNumber ; 

6 

7 public SimpleThread() 

s f 

9 threadNumber = ++threadCount ; 

10 System . out. println("Creez firul nr. " + threadNumber); 


11 } 


3 public void run() 


14 | 

15 while(true) 

16 ( 

17 System . out. println("Fir nr. " + threadNumber + "(" + 
18 countDown + ")"); 
19 if(—-—countDown == 0) 

20 { 

21 return; 

22 ) 

23 } 

24) 


2 public static void main(String [] args) 


274 

28 for(int i = 0; i < 3; i++) 

29 { 

30 new SimpleThread (). start (); 

31 } 

32 System . out. println ("Firele de executie au fost pornite."); 


3) 


execuţie. Practic, metoda run () furnizează codul care va fi executat în paralel 
cu codul celorlalte fire de execuţie din cadrul programului. 

Programul din Listing 8.1 creează 3 fire de execuţie, fiecare fir având asociat 
un număr unic, generat cu ajutorul variabilei statice threadCount. Metoda 
run () este redefinită în liniile 13-24 pentru a scădea valoarea unui contor 
(variabila countDown) la fiecare execuţie a ciclului while până când va- 
loarea contorului ajunge la 0, moment în care metoda run () se încheie, iar 
firul de execuţie este terminat. 
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În marea majoritate a cazurilor, instrucţiunile din metoda run () sunt cu- 
prinse într-o instrucţiune de ciclare care se execută până când firul de execuţie 
nu mai este necesar (în cazul nostru, până când contorul ajunge la 0). 

În metoda main (), liniile 26-32, se crează şi se pornesc 3 fire de execuţie. 
Metoda start () din clasa Thread iniţializează firul de execuţie după care 
îi apelează metoda run (). Aşadar, paşii pentru crearea unui fir de execuţie 
sunt: se apelează constructorul pentru a crea obiectul, apoi metoda start () 
configurează firul de execuţie şi apelează metoda run (). Dacă nu se apelează 
metoda start () (lucru care poate fi făcut chiar şi în constructor) firul de 
execuţie nu va fi pornit niciodată. 

Ieşirea afişată de programul din Listing 8.1 (care diferă de la o execuţie la 
alta) este: 


Creez firul nr. 1 
Creez firul nr. 2 
Fir dẹ- executie nr. 
Fir de executie nr. 
Fir de executie nr. 
Fir de executie nr. 
Creez firul nr. 3 
Fir de executie nr. 1(1) 

Firele de executie au fost pornite. 


Fir de executie nr. 3(5) 
Fir de executie nr. 3(4) 
Fir de executie nr. 3(3) 
Fir de executie nr. 2(5) 
Fir de executie: nr. 3(2) 
Fir de executie nr. 3(1) 
Fir de executie nr. 2(4) 
Fir de executie nr. 2(3) 
Fir de executie nr. 2(2) 
Fir de executie nr. 2(1) 


Observaţi că firele de execuție nu au fost executate în ordinea în care au fost 
create. De fapt, ordinea în care procesorul rulează firele de execuţie este nede- 
terminată, cu excepţia situaţiei în care se foloseşte metoda setPriority () 
pentru a modifica prioritatea de execuţie a unui thread. 

Un alt lucru demn de remarcat este că la crearea unui fir de execuţie în 
linia 30, metoda main () nu reţine nici o referinţă către obiectele nou create. 
Un obiect Java obişnuit ar fi în această situaţie disponibil pentru colectorul de 
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gunoaie (care, dacă tot veni vorba, rulează şi el pe un fir de execuţie separat), 
dar nu şi un fir de execuţie. Fiecare fir de execuţie se înregistrează pe el însuşi în 
cadrul maşinii virtuale, deci există undeva o referinţă către el, astfel încât colec- 
torul de gunoaie nu va putea să îl distrugă atât timp cât firul este în execuţie. 


Implementarea interfeţei Runnable 


Ajunşi cu lectura în acest punct al cărţii ar trebui să fiţi familiarizați cu noţi- 
unea de interfaţă, prezentată în capitolul 5. Implementarea interfeţei Runnable 
reprezintă o modalitate elegantă prin care putem face ca orice clasă care o im- 
plementează să ruleze pe un fir de execuţie distinct. lată codul pentru interfaţa 
Runnable: 


1 public interface Runnable extends Object 


2 { 
3 public abstract void run() ; 


4) 


Aşadar interfaţa Runnable este foarte simplă, însă deosebit de puternică. 
Toate clasele care implementează această interfaţă trebuie, desigur, să imple- 
menteze metoda run (). Este interesant de remarcat faptul că noul fir de exe- 
cuţie se va crea tot cu ajutorul clasei Thread, care oferă un constructor având 
ca parametru o instanţă Runnable. Clasa Thread va executa în această situ- 
aţie metoda run () a parametrului în cadrul metodei sale main (). Firul de 
execuţie se va încheia în momentul în care metoda run () se încheie. Astfel, 
această interfaţă foarte simplă permite ca oricare clasă care o implementează să 
ruleze pe un fir de execuţie separat. 

Ajunşi în acest punct, v-aţi pus probabil întrebarea: de ce este necesar să 
avem şi clasa Thread şi interfaţa Runnable? Există situaţii în care este 
mai adecvat să se implementeze interfaţa Runnable şi situaţii în care este de 
preferat să se extindă clasa Thread. Crearea unui fir de execuţie prin imple- 
mentarea interfeţei Runnable este mai flexibilă, deoarece poate fi întotdeauna 
utilizată. Nu veţi putea întotdeauna să extindeţi clasa Thread. Adevărata pu- 
tere a interfeţei Runnable iese în evidenţă în momentul în care aveţi o clasă 
care trebuie să extindă o altă clasă pentru a moşteni un anumit gen de funcţi- 
onalitate. În acelaşi timp, aţi dori ca acea clasă să ruleze pe un fir de execuţie 
separat. Aici este cazul să folosiţi Runnable. 

Odată ce aveţi o clasă care implementează Runnable şi defineşte o metodă 
run (), sunteţi pregătiţi pentru a crea un fir de execuţie. Şi în această situaţie 
va trebui să instanţiaţi clasa Thread. Fiecare fir de execuţie în Java este asociat 
cu o instanţă a clasei Thread, chiar dacă se utilizează interfaţa Runnable. 
Aşa cum am amintit deja, clasa Thread oferă un constructor care primeşte 
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ca parametru o instanţă Runnable. La instanţierea clasei Thread, cu acest 
constructor, metoda run () a clasei Thread apelează pur şi simplu metoda 
run () a clasei primită ca parametru. Puteţi verifica acest lucru cu uşurinţă, 
executând următorul program: 


1 public class TestRunnable implements Runnable 


2 { 


public static void main(String [] args) 


{ 


3 

4 

5 new Thread ( new TestRunnable () ). start (); 
6 } 
: 

8 

9 


public void run() 


{ 


new Exception ().printStackTrace (); 
10 return ; 


Programul de mai sus reprezintă un exemplu simplu de creare a unui fir de 
execuţie prin implementarea interfeţei Runnable. La linia 1 declarăm faptul 
că clasa noastră implementează interfaţa Runnable. În liniile 7-11 definim 
metoda run () care nu face decât să apeleze metoda printStackTrace () 
a clasei Exception, după care se încheie şi, odată cu ea, se încheie şi firul 
de execuţie. La linia 5 se porneşte firul de execuţie, prin crearea unei instanţe a 
clasei Thread având ca parametru Runnable chiar clasa noastră. Rezultatul 
afişat de program este: 


java.lang.Exception at 
TestRunnable.run (TestRunnable.java:9) at 
jJava.lang.Thread.run (Thread. java:484) 


ceea ce dovedeşte că metoda run () a clasei TestRunnable a fost apelată 
de metoda run () a clasei Thread. 

Programul din Listing 8.2 reprezintă varianta Runnable a programului 
din Listing 8.1. Remarcaţi diferenţele minime între cele două variante. La linia 
1, clasa SimpleRunnable declară că implementează interfaţa Runnable. 
Apoi, la linia 30 firul de execuţie se creează transmițând a instanţă a clasei 
SimpleRunnable constructorului clasei Thread. În rest, cele două pro- 
grame sunt identice. 


$.3 Accesul concurent la resurse 


Un program care rulează pe un singur fir de execuţie poate fi privit ca o 
unică entitate care se mişcă prin spaţiul problemei făcând un singur lucru la 


222 


8.3. ACCESUL CONCURENT LA RESURSE 


Listing 8.2: Exemplu simplu de fire de execuţie create prin implementarea in- 
terfeţei Runnable 


1 public class SimpleRunnable implements Runnable 


2 { 


private int countDown = 5; 
private static int threadCount = 0; 
private int threadNumber ; 
public SimpleRunnable() 
{ 
threadNumber = ++threadCount ; 
System . out. println("Creez firul nr. " + threadNumber); 
) 
public void run() 
{ 
while(true) 
{ 
System . out. println("Fir nr. ” + threadNumber + "(" + 
countDown + ")"); 
if(——countDown == 0) 
{ 
return; 
) 
) 
) 
public static void main( String [] args) 
{ 
for(int i = 0; i < 3; i++) 


{ 


new Thread( new SimpleRunnable() ). start (); 


) 


System .out.println("Firele de executie au fost pornite.”); 


) 
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un moment dat. Deoarece există doar o singură entitate nu este necesar să ne 
punem problema dacă două entităţi ar putea accesa aceeaşi resursă în acelaşi 
timp, cum ar fi de exemplu situaţia a două persoane care îşi parchează maşina 
în acelaşi loc simultan, sau care încearcă să iasă în acelaşi timp pe uşă, sau chiar 
să vorbească în acelaşi timp. 

În cazul mai multor fire de execuţie, nu mai avem o singură entitate şi există 
deci posibilitatea ca două sau mai multe fire de execuţie să încerce să utilizeze 
aceeaşi resursă în acelaşi timp. Nu întotdeauna accesarea unei resurse simultan 
este o problemă, dar sunt situaţii în care aceste coleziuni trebuie prevenite (de 
exemplu, două fire de execuţie care accesează simultan acelaşi cont în bancă, 
sau care doresc să tipărească la aceeaşi imprimantă etc.). 

Exemplul simplu de mai jos pune în evidenţă problemele care pot să apară 
într-un program multithreaded (care rulează pe mai multe fire de execuţie): 


1 public class Counter 


2 { 


3 private int count = O ; //counter incrementat de increment () 
4 public int increment() 

s | 

6 int aux = count ; 

7 count++ ; 

8 return aux ; 

* ) 


Clasa de mai sus este extrem de simplă, având un singur atribut şi o sin- 
gură metodă. Aşa cum îi sugerează şi numele, clasa Counter este utilizată 
pentru a număra diverse lucruri, cum ar fi numărul de apăsări ale unui bu- 
ton, sau numărul de accesări al unei pagini web. Esenţa clasei este metoda 
increment () care incrementează şi returnează valoarea curentă a counter- 
ului. Deşi clasa Counter pare complet inofensivă, ea consituie o potenţială 
sursă de comportament imprevizibil într-un mediu multithreaded. 

Să considerăm ca exemplu un program Java care conţine două fire de exe- 
cuţie, amândouă fiind pe cale să execute următoarea linie de cod: 


int count = counter.increment () ; 


Programatorul nu poate nici să controleze şi nici să prezică ordinea în care 
cele două fire de execuţie vor fi executate. Sistemul de operare (sau maşina 
virtuală Java) deţine controlul complet asupra planificării firelor de execuţie. 
În consecinţă, nu există nici o certitudine în privinţa cărui fir de execuţie se 
va executa, sau cât timp va fi executat un anumit fir de execuţie. Orice fir de 
execuţie poate fi întrerupt printr-o schimbare de context în orice moment. Mai 
mult, două fire de execuţie pot rula simultan pe două procesoare separate ale 
unei maşini multiprocesor. 
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Tabela 8.1 descrie o posibilă secvenţă de execuţie a celor două fire de ex- 
ecuţie. În acest scenariu, primul fir de execuţie este lăsat să ruleze până când 
încheie apelul către metoda increment (); apoi, cel de-al doilea fir face ace- 
laşi lucru. Nu este nimic surprinzător la acest scenariu. Primul fir va incrementa 
valoarea contorului la 1, iar al doilea o va incrementa la 2. 


Tabela 8.1: Counter - Scenariul 1 


Fir de execuţie 1 Fir de execuţie 2 count | aux 


III count = counter.increment( 
as count 
IE RIC 
tara ass 


Tabela 8.2 descrie o secvenţă de execuţie oarecum diferită. În această situ- 
aţie, primul fir de execuţie este întrerupt de o schimbare de context chiar în 
timpul execuţiei metodei increment (). Primul fir este astfel suspendat tem- 
porar şi se permite execuţia celui de-al doilea. Al doilea fir execută apelul către 
metoda increment (), mărind valoarea contorului la 1 şi returnând valoarea 
0. Când primul fir îşi va relua execuţia, problema devine deja evidentă. Valoarea 
contorului este crescută la 2, dar valoarea returnată este tot 0! 


Tabela 8.2: Counter - Scenariul 2 


Fir de execuţie 1 Fir de execuţie 2 count 


count counter meremeni) | — o 
nau = count Do 
count counter inerement) [O 
Taz couni  _Lo_ 
= Eaa 
IE 0 AN FE 
EE 


pe i 
turn a ITI 


Examinând scenariul din Tabela 8.2, veţi observa o secvenţă interesantă de 
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execuţie a operaţiilor. La intrarea în metoda increment (), valoarea atribu- 
tului count (0) este stocată în variabila locală aux. Primul fir este apoi sus- 
pendat pentru o perioadă, timp în care se execută celălalt fir (este important 
să observăm că valoarea lui count se modifică în această perioadă). Când 
primul fir îşi reia execuţia, el incrementează corect valoarea lui count şi re- 
turnează valoarea din aux. Problema este că valoarea din aux nu mai este 
corectă, deoarece valoarea lui count a fost modificată între timp de către 
celălalt fir. Pentru a ne convinge de faptul că scenariul din Tabela 8.2 este 
într-adevăr posibil, am extins clasa Counter prezentată anterior, adăugându- 
i clasa interioară (vezi paragraful 5.7, pagina 145) CounterTest (Listing 
8.3) derivată din Thread. Metoda run () a clasei CounterTest (liniile 34- 
42) apelează într-un ciclu infinit metoda increment () a clasei Counter. 
Variabilele check1 şi check2 declară şi iniţializează câte un obiect de tip 
CounterTest care rulează pe un fir de execuţie separat (firul de execuţie 
este pornit chiar în constructorul clasei CounterTest care apelează metoda 
start () în linia 30). 


Listing 8.3: Clasă Java care evidenţiază problemele care pot apărea la partajarea 
resurselor 


ı public class Counter 


3 private int count = 0 ; //counter incrementat de increment () 
4  //initializeaza si porneste primul thread de verificare 
s private CounterTest checkl = new CounterTest () ; 

6  //initializeaza si porneste al doilea thread de verificare 
1 private CounterTest check2 = new Counterlest () ; 

8 

9 public int increment() 

C | 

Ll int aux = count ; 

12 count++ ; 

13 if ( count != aux+l ) 

14 | 

15 System .out.printin("Oops! Ceva nu e in regula... " + 
16 this.count + " " + aux); 

17 } 

18 return aux ; 

9] 

20 

21 /** 

22 x Clasa care evidentiaza problemele de sincronizare 

23 x ale metodei increment . 

24 */ 

25 public class CounterTest extends Thread 

2 f 

27 /xx Construieste si porneste firul de executie. */ 
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public CounterTest () 
{ 


) 


this. start () ; 


/x* Apeleaza metoda increment () intr-un ciclu infinit.x*/ 
public void run) 


{ 


System . out. println ("Firul ” + this .getName() + 
"a pornit") ; 

for (;;) 

{ 


increment () ; 


) 
) 
) 


public static void main( String [|] args ) 


{ 


// creaza o instanta a clasei Counter 
new Counter () ; 


) 


În mod aparent paradoxal, după secvenţa de instrucţiuni 


int aux = count ; 
count ++ ; 


la linia 13 se verifică dacă valoarea variabilei count este diferită de aux+1 


if ( count != aux+l ) 


Acest test ar fi complet inutil într-un program care rulează pe un singur fir de 


execuţie, dar nu şi în cazul nostru. La rularea programului Counter. java, 
acesta va afişa (valorile afişate diferă, desigur, de la o execuţie la alta): 


Firul Thread-0 a pornit 
Firul Thread-l a pornit 


Oops! Ceva nu e in regula... Thread-l 18777999 

18247501 

Oops! Ceva nu e in regula... Thread-l 55129926 

54599470 

Oops! Ceva nu e in regula... Thread-0 81760783 

81229276 

Oops! Ceva nu e in regula... Thread-0 104069819 
103556887 

Oops! Ceva nu e in regula... Thread-0 118311248 
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117779680 
Oops! Ceva nu e in regula... Thread-1 279005154 
218475302 


Din cele afişate reiese că testul de la linia 13 nu este deloc inutil. Se poate 
întâmpla ca unul dintre firele de execuție ale clasei CounterTest (să zicem 
check1) să fie întrerupt imediat după ce a fost atribuită valoarea lui count 
variabilei aux, dar înainte ca metoda să apuce să returneze valoarea din aux (ca 
în scenariul din Tabela 8.2). În această situație, celălalt fir de execuție al clasei 
CounterTest,check2, va continua să incrementeze valoarea lui count de 
un număr nedeterminat de ori, după care controlul va fi din nou preluat de firul 
de execuţie întrerupt, check 1. Acesta va avea noua valoare a lui count, care 
a fost între timp incrementată, dar vechea valoare a lui aux, care (fiind variabilă 
locală) a fost salvată pe stivă înainte de schimbarea de context!, de aici rezultând 
inconsistența semnalată de testul din linia 13. Desigur, şansele ca primul fir de 
execuţie să fie întrerupt chiar după ce a fost incrementat count sunt foarte 
MICI, dovadă şi faptul că această situaţie a apărut după peste 18 milioane de 
apeluri ale metodei increment (). Totuşi, şansele există, şi neluarea lor în 
considerare poate avea consecinţe grave asupra funcţionării unui program. 

Problema pusă în evidenţă de scenariul din Tabela 8.2 poartă numele de 
inconsistenţă la concurenţă (engl. race condition)- rezultatul unui program de- 
pinde de ordinea în care s-au executat firele de execuţie pe procesor. În general, 
nu este deloc indicat să se permită incosistenţe la concurenţă în rezultatele unui 
program. Noi nu putem şti niciodată în ce moment un fir de execuţie este ex- 
ecutat sau întrerupt. Închipuiţi-vă că sunteţi aşezat la o masă cu o lingură în 
mână gata-gata să gustaţi dintr-o salată de fructe delicioasă care se află în faţa 
dumneavoastră. Vă îndreptaţi plini de speranţă lingura către salata de fructe şi, 
chiar în momentul în care să atingeţi salata, aceasta dispare fără urmă (deoarece 
firul vostru de execuţie a fost suspendat, şi între timp, alt fir de execuţie a fu- 
rat mâncarea). Mergând cu analogia mai departe, dumneavoastră nu aveţi timp 
să reacţionaţi la dispariţia farfuriei (fiecare fir de execuţie are iluzia că execută 
singur şi continuu pe procesor) şi veţi înfige lingura în masă, provocând astfel 
îndoirea ei (adeseori, folosirea simultană a unei resurse conduce la coruperea 
ei). 

Există situații în care nu are importanță dacă o resursă este accesată în ace- 
laşi timp de mai multe fire de execuție (mâncarea este pe o altă farfurie). To- 
tuşi, pentru ca programele multithreaded (rom. cu mai multe fire de execuţie) 


l Deşi nu am precizat clar acest lucru, variabilele locale sunt distincte pentru fiecare fir de exe- 
cuție în parte. Totuși, atributele claselor sunt partajate de către toate firele de execuție care rulează 
la un moment dat. 
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să funcţioneze, trebuie să existe un mecanism care să permită împiedicarea ac- 
cesului la o resursă de către mai multe thread-uri, măcar în timpul perioadelor 
critice. Să ne imaginăm ce s-ar fi întâmplat dacă metoda increment () ar 
fi fost utilizată pentru a actualiza contul în bancă al unei persoane în loc să 
incrementeze pe count. Pentru o bancă, corectitudinea conturilor este de im- 
portanță maximă. Dacă o bancă face erori de calcul sau raportează informaţii 
incorecte, cu siguranţă nu îşi va încânta clienţii. 

Orice programe multithreaded, chiar şi cele scrise în Java, pot suferi de in- 
consistenţă la concurenţă. Din fericire, Java ne pune la dispoziţie un mecanism 
simplu pentru a controla concurenţa: monitoarele. 


$.3.1  Sincronizare 


Există multe lucrări de programare şi sisteme de operare care se ocupă de 
problema programării concurente. Concurența a fost un subiect foarte cercetat 
în ultimii ani. Au fost propuse şi implementate mai multe mecanisme de control 
al concurenţei, printre care: 


e secţiunile critice; 

e semafoare; 

e mutexuri; 

e blocarea de înregistrări în baze de date; 


e monitoare. 


Limbajul Java implementează o variantă a monitoarelor (engl. monitors) pentru 
controlul concurenţei. Conceptul de monitor a fost introdus de C.A.R. Hoare 
(acelaşi Hoare care a propus şi algoritmul de partiţionare de la Quicksort) în 
anul 1974 într-o lucrare publicată în Communications of the ACM. Hoare de- 
scrie în această lucrare un obiect special, denumit monitor, care este utilizat 
pentru a furniza excluderea reciprocă pentru un grup de proceduri (“excludere 
reciprocă” este un mod elegant de a spune “Un singur fir de execuţie la un mo- 
ment dat”). În modelul propus de Hoare, fiecare grup de proceduri care necesită 
excludere reciprocă este pus sub controlul unui monitor. În timpul execuţiei, 
monitorul permite să se execute doar o singură procedură aflată sub controlul 
lui la un moment dat. Dacă un alt fir de execuţie încearcă să apeleze o pro- 
cedură controlată de monitor, acel fir este suspendat până în momentul în care 


firul curent îşi încheie apelul. 
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Monitoarele din Java implementează îndeaproape conceptele iniţiale ale lui 
Hoare, aducând doar câteva modificări minore (pe care nu le vom prezenta în 
această carte). Monitoarele din Java impun excluderea reciprocă la accesarea 
de metode, sau, mai exact, excluderea reciprocă la accesarea de metode sin- 
cronizate (vom vedea imediat un exemplu concret de metodă sincronizată). 

În momentul în care se apelează o metodă Java sincronizată se declanşează 
un proces deosebit de laborios. În primul rând, maşina virtuală Java va localiza 
monitorul asociat cu obiectul a cărui metodă este apelată (de exemplu, dacă 
se apelează counter .increment (), maşina virtuală va localiza monitorul 
lui counter). Orice obiect Java poate să aibă un monitor asociat, deşi, din 
motive de eficienţă, maşina virtuală crează monitoarele doar atunci când este 
nevoie de ele. Odată ce monitorul este găsit, maşina virtuală încearcă să atribuie 
monitorul firului de execuţie care a apelat metoda sincronizată. Dacă monitorul 
nu este atribuit altui fir de execuţie, se va atribui firului curent, căruia îi este 
apoi permis să continue cu apelul metodei. În situaţia în care monitorul este deja 
deţinut de către un alt fir de execuţie, el nu va putea fi atribuit firului curent, care 
va fi pus în aşteptare până când monitorul va fi eliberat. În momentul în care 
monitorul va deveni disponibil, aceasta va fi atribuit firului de execuţie curent, 
care va putea continua cu apelul metodei. 

Metaforic vorbind, un monitor acţionează ca un fel de secretară aflată la in- 
trarea în birou a unei persoane foarte solicitate. În momentul în care se apelează 
o metodă sincronizată, secretara permite firului apelant să treacă, după care 
închide uşa de la birou. Atâta timp cât firul este în cadrul metodei sincronizate, 
apelurile către alte metode sincronizate ale obiectului sunt blocate. Aceste fire 
se aşează la coadă în faţa uşii de la birou, aşteptând cu răbdare ca primul fir să 
plece. În momentul în care primul fir părăseşte metoda sincronizată, secretara 
deschide din nou uşa de la birou permiţând unui singur fir din coada de aşteptare 
să intre pentru a-şi executa metoda sincronizată, după care procesul se repetă 
din nou. 

Mai simplu spus, un monitor Java impune un acces de tipul un singur fir la 
un moment dat. Această operaţie mai este numită adeseori şi serializare (a nu 
se confunda cu serializarea obiectelor, care permite să citim şi să scriem obiecte 
Java într-un stream (rom. flux de date). Aici serializare are sensul de a permite 
accesul succesiv). 


Observaţie: Programatorii care sunt deja familiarizați cu conceptul de pro- 
gramare multithreaded din alte limbaje de programare, tind adeseori să con- 
funde monitoarele cu secţiunile critice. Declararea unei metode sincronizate 
nu implică faptul că doar un singur fir de execuţie va executa acea metodă la 
un moment dat, cum este cazul la secţiunile critice. Ea impune doar ca numai 
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un singur fir de execuţie să poată executa acea metodă (sau oricare altă metodă 
sincronizată) pe un anumit obiect la un moment dat. Monitoarele din Java sunt 
asociate cu obiecte, şi nu cu linii de cod. Este foarte posibil ca două fire de exe- 
cuţie să execute simultan aceeaşi metodă sincronizată, cu condiţia ca metoda să 
fie invocată pe obiecte distincte (adică a.method () şi b.method (), unde 
a!=b). 


Pentru a vedea cum operează monitoarele, să rescriem clasa Counter, ast- 
fel încât să se folosească de monitoare, prin intermediul cuvântului cheie syn- 
chronized. 


Listing 8.4: Clasa Counter cu metoda sincronizată 


ı public class CounterSync 
{ 
private int count = 0 ; //counter incrementat de increment () 
public synchronized int increment () 
{ 
int aux = count ; 
count++ ; 
return aux ; 


© © N A n A ù N 


— 
© 
—— 


Observaţi că nu a fost necesar să rescriem metoda increment () - aceasta 
a rămas la fel ca în exemplul anterior, cu deosebirea că metoda a fost declarată 
a fi synchronized. 


Ce s-ar întâmpla dacă am folosi clasa CounterSync în programul din 
Listing 8.3? Ar mai fi posibilă apariţia scenariului din Tabela 8.2, care pune în 
evidenţă inconsistenţa la concurenţă? Rezultatul aceleiaşi secvenţe de schim- 
bări de context, nu ar mai fi identic, deoarece metoda sincronizată va împiedica 
inconsistenţa la concurenţă. Scenariul modificat din Tabela 8.2 este prezentat 


în Tabela 8.3. 
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Tabela 8.3: Counter - Scenariul 3 


Fir de execuţie 1 Fir de execuţie 2 


suni = counterincremem0 | — 
bine monitor | = 
incas > cun 0 | = 
EO 
mu poate obtine monitorul) 
edi monitor 
TI ni as > coun m 
IE ERIC AI 
a ae n 
E irimo 


Secvența de operaţii din Tabela 8.3 începe la fel ca cea din scenariul an- 
terior: primul fir de execuţie începe să execute metoda increment () a cla- 
sei CounterSync, după care este întrerupt de o schimbare de context. To- 
tuşi, de data aceasta, în momentul în care al doilea fir de execuţie doreşte 
să apeleze metoda increment () pe acelaşi obiect de tip CounterSync, 
acesta este blocat. Tentativa celui de-al doilea fir de a obţine monitorul obiec- 
tului eşuează, deoarece acesta este deja deţinut de primul fir. În momentul în 
care primul fir eliberează monitorul, al doilea fir îl va putea obţine şi va executa 
metoda increment (). Putem să ne convingem de aceasta, modificând pro- 
gramul din Listing 8.3 prin adăugarea cuvântului synchronized la metoda 
increment (). La execuţie programul va afişa: 


Firul Thread-0 a pornit 
Firul Thread-l a pornit 


după care va rula până când va fi oprit cu CTRL-C, fără a mai afişa nici un 
mesaj. 

Cuvântul cheie synchronized este singura soluţie pe care limbajul Java 
o oferă pentru controlul concurenţei. Aşa cum s-a văzut şi în exemplul cu clasa 
Counter, incosistenţa potenţială la concurenţă a fost eliminată prin adăugarea 
modificatorului synchronized la metoda increment (). Astfel, toate a- 
pelurile metodei increment () au fost serializate. În general vorbind, mo- 
dificatorul synchronized ar trebui adăugat la orice metodă care modifică 
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atributele unui obiect. Adeseori este deosebit de dificil să examinăm metodele 
unei clase pentru a detecta posibile inconsistenţe la concurenţă. Este mult mai 
comod să marcăm toți modificatorii ca fiind synchronized, rezolvând astfel 
orice problemă de concurenţă. 


Observaţie: Unii programatori mai curioşi s-ar putea întreba când o să vadă 
şi ei un monitor Java. Totuşi, acest lucru nu este posibil. Monitoarele Java nu 
dispun de o descriere oficială în specificaţia Java, iar implementarea lor nu este 
direct vizibilă pentru un programator. Monitoarele nu sunt obiecte Java: ele nu 
au atribute sau metode. Monitoarele sunt un concept aflat la baza implementării 
modelului de concurenţă în Java. Se poate accesa monitorul unui obiect la nivel 
de cod nativ, dar acest lucru nu este recomandat, iar descrierea lui depăşeşte 
cadrul acestui capitol. 


8.3.2 Capcana metodelor nesincronizate 


Monitoarele din Java sunt folosite doar în conjuncție cu metodele syn- 
chronized?. Metodele care nu sunt declarate ca fiind synchronized nu 
încearcă să obţină monitorul obiectului înainte de a fi executate. Ele pur şi sim- 
plu ignoră complet monitoarele. La un moment dat, cel mult un fir de execuţie 
poate să execute o metodă sincronizată a unui obiect, dar un număr arbitrar de 
fire de execuţie pot executa metode nesincronizate. Acest fapt poate să prindă 
pe picior greşit mulţi programatori începători, care nu sunt suficient de atenţi la 
care metode trebuie declarate synchronized şi care nu. Să considerăm clasa 
Account din Listing 8.5, care descrie un cont în bancă împreună cu operaţiile 
care se realizează asupra lui. 


Listing 8.5: Clasa Account 


public class Account 
{ 


private int balance; 
/x* Creaza un cont cu soldul balance */ 
public Account(int balance) 


{ 


© © A A ù A ù N = 


this.balance = balance; 
/* x 
10 x Transfera suma amount din contul curent 
Ll x in contul destination 
12 */ 


? Afirmația este un pic inexactă. Vom vedea imediat că monitoarele Java sunt folosite şi în cazul 
instrucţiunii synchronized (). 
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3 public synchronized void transfer(int amount, 


14 Account destination) 
5 4 

16 this . withdraw (amount); 

17 destination .deposit (amount ); 


8) 
9 /xx Retrage suma amount din cont */ 
2 public synchronized void withdraw(int amount) 


2l 
{ 
22 balance —= amount; 
de-a] 
24 /xx*x Depune suma amount in cont */ 
25 public synchronized void deposit(int amount) 
2 f 
27 balance += amount; 
2) 
2  /xx* Returneaza soldul din cont +*/ 
3 public int getBalance () 


a f 


32 return balance; 
sa.) 


Toţi modificatorii clasei Account sunt declaraţi ca fiind synchronized. 
Aparent, această clasă nu ar trebui să aibă nici un fel de probleme legate de 
inconsistenţa la concurenţă. Şi totuşi, ea are! 

Pentru a înţelege inconsistenţa la concurenţă de care suferă clasa Account, 
să vedem cum lucrează o bancă cu conturile. Pentru o bancă este de o impor- 
tanţă majoră să menţină corectitudinea datelor din conturi. Pentru a evita ra- 
portarea de informaţii inconsistente, băncile preferă ca, în timp ce se realizează 
o tranzacţie, să dezactiveze cererile privitoare la soldul dintr-un cont. Astfel, 
clienţii băncii nu pot să primească informaţii preluate în timpul unei tranzacţii 
parţial încheiate. Metoda getBalance () din clasa Account nu este sin- 
cronizată, iar acest fapt poate conduce la anumite probleme. 

Să presupunem că un fir de execuţie apelează metoda sincronizată trans- 
fer (), pentru a trece suma de 10 milioane de lei din contul curent în alt cont. 
Mai mult, firul nostru de execuţie este întrerupt de o schimbare de context ime- 
diat după ce a executat linia 16: 


this . withdraw (amount); 


În acest moment, suma de 10 milioane a fost extrasă din primul cont, dar 
încă nu a fost depozitată în celălalt cont. Dacă un alt fir de execuţie va apela 
metoda (nesincronizată!) getBalance () pentru cele două conturi implicate 
în transfer, aceasta va putea accesa nestingherită informaţia din cele două con- 
turi. Astfel, getBalance () va raporta că suma de 10 milioane de lei a fost 
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extrasă din primul cont, dar această sumă nu se va regăsi în contul destinaţie, 
deoarece metoda transfer () nu a apucat să actualizeze acest cont înainte de 
a fi întreruptă! Astfel, clienţii s-ar putea întreba unde a dispărut suma respec- 
tivă3. Dacă getBalance () ar fi fost sincronizată, acest scenariu nu ar fi fost 
posibil, deoarece apelul ei ar fi fost blocat până la încheierea tranzacţiei. 


8.3.3 Instrucţiunea synchronized 


Metodele sincronizate nu pot fi folosite în orice situaţie. De exemplu, şirurile 
Java nu dispun de metode, cu atât mai puţin de metode sincronizate. Există 
totuşi multe cazuri în care dorim ca accesul la elementele unui şir să fie sin- 
cronizat. Pentru a rezolva această situaţie, limbajul Java oferă şi o altă convenţie 
sintactică prin care putem interacţiona cu monitorul unui obiect: instrucţiunea 
synchronized, cu următoarea sintaxă: 


synchronized ( expresie ) 
instructiune 
urmatoarea instructiune 


Execuţia unei instrucţiuni synchronized are acelaşi efect ca şi apelarea 
unei metode sincronizate: firul de execuţie va trebui să deţină un monitor înainte 
de a executa instrucţiune (care poate fi simplă sau compusă). În cazul 
instrucţiunii synchronized se va utiliza monitorul obiectului obţinut prin 
evaluarea lui expresie (al cărei rezultat nu trebuie să fie un tip primitiv). 

Instrucţiunea synchronized este cel mai adesea folosită pentru a seria- 
liza accesul la obiecte de tip array. Secvența de cod de mai jos este un exemplu 
de cum se poate serializa accesul concurenţial la elementele unui şir: 


1/*x* Incrementeaza elementul de pe pozitia poz.*/ 
2 void increment(byte[] sir, int poz) 

3 { 

4 synchronized ( sir ) 


{ 


sir [ poz ]++ ; 


o N A U 


În exemplul anterior, maşina virtuală Java va atribui monitorul lui sir? 


firului de execuție curent, înainte de a încerca să incrementeze elementul de pe 
poziţia poz. Alte fire de execuţie care ar încerca să obţină monitorul acestui şir 


3 Acest exemplu nu este concludent pentru multe bănci din România, care au nevoie de un inter- 
val de 2 zile pentru ca suma transferată dintr-un cont să apară în celălalt cont... 
+Deşi nu sunt obiecte în adevăratul sens al cuvântului, şirurile din Java au anumite proprietăţi 


specifice obiectelor, printre care şi monitorul. 
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vor fi forţate să aştepte până când se încheie operaţia de incrementare. Trebuie 
însă să avem în vedere faptul că accesul la elementele şirului va fi totuşi permis 
în cadrul altor instrucţiuni care nu sunt sincronizate pe monitorul şirului. 

Instrucţiunea synchronized este utilă şi atunci când dorim să modificăm 
un obiect fără a folosi metode sincronizate. Această situaţie poate să apară 
atunci când se modifică atributele publice ale unui obiect (deşi am arătat deja că 
utilizarea de atribute publice nu este de dorit) sau se apelează o metodă care nu 
este sincronizată (dar ar trebui să fie) şi noi nu o putem modifica (de exemplu, 
pentru că este moştenită de la un alt obiect). Iată un exemplu: 


ı void metoda ( OClasa obiect ) 


2 { 


3 synchronized( obiect ) 


{ 


) 
) 


obiect. metoda_care_ar_trebui_sa_fie_sincronizata_dar_nu_e () ; 


a N Un A 


O metodă sincronizată este echivalentă cu o metodă nesincronizată ale cărei 
instrucţiuni sunt cuprinse într-un bloc synchronized pe monitorul obiectu- 
lui (this). Astfel, metoda 


ı synchronized void f() 


2 { 


3 instructiune ; 


4) 

este echivalentă cu metoda 
ı void f() 
2 | 


3 synchronized ( this ) 


instructiune ; 


) 


Ia Nu A 


) 


Observaţie: Instrucţiunea synchronized ne oferă posibilitatea de a utiliza 
monitoarele oricărui obiect Java. Totuşi, folosirea instrucţiunii synchronized 
în situaţii în care ar fi fost suficientă declararea unei metode sincronizate duce 
uneori la un cod greoi şi dificil de depanat. Adăugarea modificatorului synchro- 
nized la antetul unei metode defineşte foarte clar ce se petrece atunci când 
metoda este apelată. 
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8.3.4 Competiţie asupra monitoarelor 


Se poate întâmpla ca două sau mai multe fire de execuţie să fie blocate în 
aşteptarea obţinerii aceluiaşi monitor. Această situaţie apare atunci când un fir 
de execuţie deţine monitorul unui anumit obiect. Dacă un alt fir de execuţie 
încearcă să execute una din metodele sincronizate ale aceluiaşi obiect, firul va fi 
suspendat, în aşteptarea eliberării monitorului. Dacă un al treilea fir de execuţie 
încearcă şi el să apeleze o metodă sincronizată a obiectului, va fi şi el suspendat. 
În momentul în care monitorul va deveni disponibil, vor fi două fire de execuţie 
care aşteaptă să îl obţină. 

În situaţia în care două sau mai multe fire de execuţie aşteaptă obţinerea 
aceluiaşi monitor, maşina virtuală Java va trebui să aleagă doar un singur fir şi 
să îi atribuie acestuia monitorul. Nu există nici o garanţie în privinţa regulii 
după care maşina virtuală va decide care fir va fi ales. Specificaţia limbajului 
Java prevede ca doar un singur fir de execuţie să obţină monitorul, fără a preciza 
un algoritm după care maşina virtuală să aleagă firul de execuţie. De exemplu, 
maşina virtuală Java care rulează pe Solaris, alege firul de execuţie în funcţie de 
prioritate cu primul venit-primul servit în cazul în care priorităţile sunt egale. 
Totuşi, maşina virtuală Java de pe Win32 foloseşte algoritmii de planificare 
specifici Win32. 

Astfel, nu este posibil să prevedem ordinea în care firele de execuţie vor 
obţine un monitor în cazul în care mai multe fire de execuţie sunt în aşteptarea 
lui, şi de aceea trebuie să evitaţi scrierea de cod care ar depinde de această 
ordine. 


$.3.5  Sincronizarea metodelor statice 


Am văzut deja că, pentru a putea fi executate, metodele care sunt declarate 
a fi sincronizate, sunt obligate să deţină monitorul obiectului pentru care au fost 
apelate. Ce putem însă spune atunci despre metodele statice, care, după cum 
ştim, nu trebuie neapărat apelate în conjuncţie cu un obiect (metodele statice 
sunt specifice claselor, şi nu obiectelor)? 

Soluţia oferită de Java este simplă: în momentul în care se apelează o 
metodă statică sincronizată, aceasta va trebui să obţină un monitor special, care 
este asociat fiecărei clase în parte. Cu alte cuvinte, fiecare clasă Java are asociat 
un monitor care controlează accesul la metodele statice sincronizate ale clasei. 
Rezultă de aici că doar o singură metodă statică sincronizată se poate executa la 
un moment dat în cadrul unei clase. 

Un fapt care merită remarcat este că, în implementarea actuală, maşina vir- 
tuală Java foloseşte pentru sincronizarea metodelor statice monitorul instanţei 


237 


8.3. ACCESUL CONCURENT LA RESURSE 


de tip java.lang.Class asociat clasei respective. Aşa cum am văzut şi 
în paragraful 5.8.2, pagina 165, instanţele clasei java.lang.Class descriu 
toate clasele şi interfețele existente în cadrul unei aplicaţii Java aflată în exe- 
cuţie. Fiecare clasă sau interfaţă Java (chiar şi tipurile primitive) are asociată 
o instanţă de tip java.lang.Class. Obiectele de tip Class sunt constru- 
ite automat de către maşina virtuală Java pe măsură ce clasele sunt încărcate 
în memorie. Prin intermediul unei instanţe java.lang.Class asociată unei 
clase se pot obţine informaţii despre clasa respectivă, cum ar fi numărul de 
atribute şi tipul lor, metodele clasei, pachetul din care clasa face parte etc. 
Instanţa java.lang.Class asociată unei clase poate fi obţinută folosind 
metoda getClass () definită chiar în clasa Object. Ajunşi în acest punct, 
vă întrebaţi, probabil, la ce ne foloseşte să avem o clasă care să descrie con- 
ținutul fiecărei clase? Răspunsul este că această clasă este piatra de temelie a 
aşa-numitului Reflection API (vezi capitolul 5.8.2), care este folosit în debug- 
ger-e”, serializare şi deserializare de obiecte etc. 

Pentru a ne convinge de faptul că metodele statice folosesc monitorul aso- 
ciat instanţei java.lang.Class,să studiem clasa StaticMonitorTest 
de mai jos: 


public class StaticMonitorTest extends Thread 
{ 


public void run() 


{ 


l 
2 
3 
4 
5 synchronized ( getClass () ) 
6 
7 
8 
9 


{ 


System . out. println ("Se executa run()"); 
try |! sleep (5000); } catch (InterruptedException _) { } 
) 
o) 


2 public static synchronized void staticF() 


Bo è f 


14 System . out. println ("Se executa staticF()"); 
15 try | sleep (5000); } catch (InterruptedException _) { } 
6) 


8 public static void main(String |[] args) 


9 | 


20 new StaticMonitorlest(). start (); 
21 staticF (); 
dp } 


La rularea acestei clase pe Linux sau Win32, se afişează mesajul “Se ex- 


“aplicaţii folosite în depanarea programelor 
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ecuta staticF()”, după care urmează o pauză de 5 secunde, se afişează 
“Se executa run()” şi programul se încheie după o pauză de încă 5 se- 
cunde. Rezultă clar de aici că monitorul folosit pentru metoda statică este ace- 
laşi cu monitorul obiectului de tip Class asociat. Nu se ştie dacă ne putem 
baza pe acest comportament şi în versiunile viitoare de Java. Un lucru este to- 
tuşi cert: două metode statice definite în cadrul aceleiaşi clase vor utiliza acelaşi 
monitor. 


8.3.6 Monitoare şi atribute publice 


Am arătat deja că declararea de atribute publice nu este de dorit. Acest lucru 
devine şi mai evident dacă privim problema din perspectiva accesului concurent. 
Atributele publice ale unui obiect pot fi accesate de către un fir de execuţie fără 
a beneficia de protecţia oferită de metodele sincronizate. De fiecare dată când 
declarăm un atribut ca fiind public, lăsăm controlul asupra actualizării acelui 
atribut în seama oricărui programator care ne utilizează clasa, ceea ce poate 
conduce cu uşurinţă la inconsistenţă la concurenţă. 


Observaţie: Programatorii Java obişnuiesc adeseori să declare constante sim- 
bolice sub forma unor atribute statice de tip final public. Atributele de- 
clarate în acest fel nu pun probleme la concurenţă, deoarece inconsistenţele pot 
apărea doar în conjuncţie cu obiecte a căror valoare nu este constantă. 


$.3.7 Când NU trebuie să folosim sincronizarea 


Ajunşi în acest punct cu lectura acestui capitol ar trebui să fiţi deja capabili 
să scrieţi cod thread-safe€, folosind cuvântul cheie synchronized. Să ve- 
dem acum când este într-adevăr necesar să folosim metode sincronizate şi care 
sunt dezavantajele folosirii unor astfel de metode. 

Cel mai adesea, programatorii nu folosesc instrucţiunea synchronized 
deoarece scriu cod single-threaded (pe un singur fir de execuţie). De exemplu, 
rutinele care solicită procesorul intensiv nu beneficiază prea mult de fire multi- 
ple de execuţie. Un compilator nu are performanţe semnificativ mai bune dacă 
rulează pe mai multe fire de execuţie. Ca dovadă, compilatorul Java de la Sun 
nu conţine prea multe metode sincronizate, deoarece se consideră că rulează în 
special în propriul său fir de execuţie, fără a fi necesar să partajeze resursele cu 
alte fire de execuţie. 

Un alt motiv comun pentru evitarea metodelor sincronizate este că ele nu 
sunt la fel de eficiente ca metodele nesincronizate. Anumite teste simple au pus 


Scod care nu crează probleme prin execuţia pe mai multe fire 
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în evidenţă faptul că metodele sincronizate sunt de aproximativ patru ori mai 
lente decât variantele lor nesincronizate. Aceasta nu implică neapărat faptul că 
întreaga aplicaţie va fi de patru ori mai lentă, dar este o problemă care trebuie 
avută în vedere. Există programe care necesită drămuirea fiecărui gram de uti- 
lizare din sistemul pe care rulează (de exemplu, programele Java care rulează 
pe PDA-uri). În asemenea situaţii este adeseori adecvat să eliminăm surplusul 
de calcule generat de metodele sincronizate acolo unde este posibil. 

Îmbunătăţiri ale performanţei pot să apară şi dacă, în loc să declarăm o 
metodă întreagă ca fiind sincronizată, folosim un bloc synchronized doar 
pentru cele câteva instrucţiuni care trebuie să fie sincronizate. Aceasta se aplică 
mai ales atunci când avem metode lungi, care realizează multe calcule, şi doar 
o mică porţiune din ele este susceptibilă de inconsistenţă la concurenţă. 


8.3.8  Blocare circulară (deadlock) 


Blocarea circulară, numită uneori şi îmbrăţişare mortală este unul dintre 
cele mai grave evenimente care pot să apară într-un mediu multithreaded. Pro- 
gramele Java nu sunt imune la blocări circulare (deadlocks), iar programatorii 
trebuie să fie atenţi pentru a le evita. 

O blocare circulară este o situaţie în care două sau mai multe fire de execuţie 
sunt blocate în aşteptarea unei resurse şi nu pot continua execuţia. În cazul cel 
mai simplu, avem două fire de execuţie fiecare dintre ele aşteptând eliberarea 
unui monitor deţinut de celălalt fir. Fiecare fir este pus în aşteptare, până când 
monitorul dorit devine disponibil. Totuşi, acest lucru nu se va realiza niciodată. 
Primul fir aşteaptă monitorul deţinut de al doilea fir, iar al doilea aşteaptă mo- 
nitorul deţinut de primul. Deoarece fiecare fir este în aşteptare, nici unul nu va 
elibera monitorul necesar celuilalt fir. 

Programul din Listing 8.6 este un exemplu simplu menit să vă dea o idee 
despre cum poate să apară o blocare circulară. 


Listing 8.6: Exemplu de blocare circulară 


1/x* Clasa care provoaca o blocare circulara prin 

2 * pornirea a doua fire de executie care se asteapta reciproc. */ 
3 public class Deadlock implements Runnable 

al 

s private Deadlock otherThread ; 


"PDA = Personal Digital Assistant, cunoscute şi sub numele de Handheld PC sau Palm, repre- 
zintă unităţi mobile de dimensiune mică având capacitatea de a stoca şi retrage informație. Au fost 
folosite în special ca nişte agende electronice, capabile să rețină adrese, întâlniri etc. Funcționa- 
litatea lor s-a extins în prezent, fiind capabile de operații mai complexe, cum ar fi vizualizarea de 
documente, consultarea poştei electronice (email), calcul tabelar etc. 
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6 public static void main(String [] args) 
74 

8 Deadlock dl = new Deadlock (); 

9 Deadlock d2 = new Deadlock (); 

10 Thread t1 = new Thread (dl ); 

LL Thread t2 = new Thread (d2); 


13 dl .otherThread = d2; 
14 d2 .otherThread = dl; 
15 tl.start(); 
16 t2.start(); 


2 public synchronized void run() 


2 {f 


22 try | Thread.sleep (2000); } catch(InterruptedException e) { } 
23 System.out.printin("'am intrat in metoda run"); 
24 otherThread .syncMethod (); 


25) 


21 public synchronized void syncMethod () 
28 ë { 


29 try | Thread.sleep (2000); } catch(InterruptedException e) { } 
30 System . out. println ("Am intrat in metoda sincronizata"); 


zu) 


În acest exemplu, metoda main () lansează în liniile 15-16 două fire de exe- 
cuţie, fiecare dintre ele apelând metoda sincronizată run () a clasei Deadlock. 
Când primul fir se trezeşte (după ce a dormit 2 secunde) la linia 23 afişează 
mesajul de intrare în metoda run (), după care încearcă să apeleze metoda 
syncMethod () a celuilalt fir de execuţie la linia 24. Evident, monitorul 
celuilalt obiect este deţinut de al doilea fir de execuţie, aşa că primul fir stă 
şi aşteaptă eliberarea monitorului. În momentul în care se trezeşte, al doilea 
fir încearcă să apeleze syncMethod () a primului fir. Cum monitorul primu- 
lui fir este deja deţinut de metoda run () a acestuia, şi al doilea fir va intra în 
aşteptare. Cele două fire de execuţie vor aştepta unul după altul şi nu îşi vor 
continua niciodată execuţia. Acest fapt este demonstrat şi de mesajele afişate la 
execuţia programului: 


Am intrat in metoda run 
Am intrat in metoda run 


după care programul se blochează fără să mai facă nimic, până când este între- 
rupt cu CTRL-BREAK. 
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Observaţie: Putem vedea exact ce se întâmplă în cadrul maşinii virtuale Java 
folosind următorul truc valabil pentru JDK pe Solaris şi Linux (pe Windows 
nu funcţionează): apăsaţi CTRL+\ în fereastra de terminal în care rulează apli- 
caţia Java. Aceasta are ca efect afişarea pe ecran a stării în care se află maşina 
virtuală. Iată o secvenţă din textul afişat de maşina virtuală după ce am apăsat 
CTRL+ la câteva secunde după lansarea aplicaţiei Deadlock: 

"Thread-l” prio=l tid=0x80b2e00 nid=0x9b5 waiting 

for monitor entry [0xbe7ff000.  .0xbe7/ff8b0] 

at Deadlock.syncMethod (Deadlock.java:30) 

at Deadlock.run (Deadlock.java:25) 

at java.lang.Thread.run (Thread. ]java:484) 

"Thread-0" prio=1l tid=0x80b2600 nid=0x9b4 waiting 

for monitor entry [O0xbe9ff000.  .0xbe9ff8b0] 

at Deadlock.syncMethod (Deadlock.java:30) 

at Deadlock.run (Deadlock.java:25) 

at java.lang.Thread.run (Thread. ]java:484) 

Reiese de aici clar că ambele fire de execuţie (Thread-l şi Thread-0) 
aşteaptă eliberarea unui monitor în cadrul metodei run (). 

Există numeroşi algoritmi pentru prevenirea şi detectarea blocării circulare, 
dar prezentarea lor depăşeşte cadrul acestui capitol (există multe manuale de 
baze de date şi sisteme de operare care discută pe larg algoritmii de detectare a 
blocajelor circulare). Din păcate, maşina virtuală Java nu face nimic pentru a 
detecta blocajele circulare. Totuşi specificaţiile Java nu împiedică acest lucru, 
aşa că nu este exclus ca această facilitate să fie adăugată maşinii virtuale în 
versiunile viitoare. 


8.4 Coordonarea firelor de execuţie 


În paragraful precedent am văzut modul în care monitorul unui obiect poate 
fi utilizat pentru a serializa accesul la o anumită secvenţă de cod. Totuşi, moni- 
toarele sunt mai mult decât nişte obiecte de blocare (lock), deoarece ele pot 
fi utilizate şi pentru a coordona execuţia mai multor fire de execuţie folosind 
metodele wait () şinotify(). 


8.4.1 Dece este necesar să coordonăm firele de execuţie? 


Firele de execuţie din cadrul unui program Java sunt adeseori interdepen- 
dente; un fir de execuţie poate să depindă de un alt fir de execuţie care trebuie 
să încheie o anumită operaţie sau să satisfacă o cerere. De exemplu, un program 
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de calcul tabelar poate să realizeze un calcul care solicită intensiv procesorul pe 
un fir de execuţie separat. Dacă un fir de execuţie ataşat interfeţei utilizator 
încearcă să actualizeze imaginea afişată de program, acesta va trebui să se coor- 
doneze cu firul care realizează calculul, începând actualizarea imaginii doar în 
momentul în care firul de calcul s-a încheiat. 

Există foarte multe situaţii în care este util să coordonăm două sau mai multe 
fire de execuţie. Lista care urmează identifică unele dintre situaţiile mai uzuale: 


e Zonele tampon (buffere) partajate sunt adeseori utilizate pentru a trans- 
mite date între firele de execuţie. În această situaţie, există de obicei un 
fir de execuţie care scrie în buffer (numit writer sau producător) şi un fir 
care citeşte din buffer (numit reader sau consumator). Când firul con- 
sumator citeşte din buffer, trebuie să se coordoneze cu firul producător, 
citind date din buffer doar după ce acestea au fost plasate acolo de pro- 
ducător. Dacă bufferul este gol, firul consumator trebuie să aştepte noi 
date (fără să verifice încontinuu dacă au venit date!). Firul producător 
trebuie să-l notifice pe consumator când a scris ceva în buffer, pentru ca 
acesta să poată să continue citirea; 


e Dacăo aplicaţie trebuie să răspundă cu promptitudine la acţiunile utiliza- 
torului, dar ocazional trebuie să realizeze anumite calcule numerice in- 
tensive, putem rula firul de calcul numeric cu o prioritate mică (folosind 
metoda setPriority () din clasa Thread). Toate firele de execuţie 
de prioritate mai mare care au nevoie de rezultatul calculului vor aştepta 
ca firul cu prioritate mai mică să se încheie, moment în care acesta va 
notifica toate firele de execuţie interesate că şi-a încheiat calculul; 


e Un fir de execuţie poate fi construit în aşa manieră încât execută anu- 
mite operaţii ca răspuns la anumite evenimente generate de alte fire de 
execuţie. Dacă nu există nici un eveniment netratat, firul este suspendat 
(un fir de execuţie care nu face nimic nu ar trebui să consume procesor). 
Firele de execuţie care generează evenimente trebuie să aibă la dispozi- 
ție un mecanism prin care să notifice firul care aşteaptă de faptul că s-a 
produs un eveniment. 


Nu este întâmplător faptul că exemplele de mai sus au folosit în mod repetat 
cuvintele “aşteaptă” şi “notifică”. Aceste două cuvinte exprimă conceptele care 
stau la baza coordonării firelor de execuţie: un fir aşteaptă producerea unui 
eveniment, iar un alt fir notifică producerea acelui eveniment. Aceste cuvinte, 
wait (aşteaptă) şi notify (notifică) sunt folosite şi în Java, ca numele metodelor 
care se apelează pentru a coordona firele de execuţie (wait () şi notify() 


din clasa Object). 
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Aşa cum am arătat în paragraful 8.3.1 din cadrul acestui capitol, fiecare 
obiect Java are asociat un monitor. Acest fapt devine foarte util în acest mo- 
ment, deoarece vom vedea că monitoarele sunt folosite şi pentru a implementa 
primitivele de coordonare a firelor de execuţie. Deşi monitoarele nu sunt accesi- 
bile în mod direct programatorului, clasa Object furnizează două metode prin 
intermediul cărora putem interacţiona cu monitorul unui obiect. Aceste două 
metode sunt wait () şinotify(). 


8.4.2 wait() şinotify() 


Firele de execuţie sunt de obicei coordonate folosind conceptul de condiție 
sau variabilă condiţională. O condiţie reprezintă o stare sau un eveniment fără 
de care firul de execuţie nu poate continua execuţia. În Java, acest model este 
exprimat în general sub forma 


while ( ! conditia _dupa_care_astept ) 


2 { 


3 wait () ; 


4) 


La început, se verifică dacă variabila condiţională este adevărată. Dacă da, 
nu este necesar să se aştepte. În cazul în care condiţia nu este încă adevărată, se 
apelează metoda wait (). Când aşteptarea (wait () ) se încheie (fie pentru că 
firul a fost notificat, fie pentru că a expirat timpul de aşteptare) se verifică din 
nou condiţia pentru a ne asigura că a devenit adevărată (dacă suntem siguri că a 
devenit adevărată, putem înlocui ciclul while cu un simplu if). 

Apelul metodei wait () pe un obiect opreşte temporar firul de execuţie 
curent până când un alt fir apelează notify (), pentu a informa firul care 
aşteaptă că s-a produs un eveniment care ar putea schimba condiţia de aşteptare. 
Cât timp un fir de execuţie aşteaptă în cadrul unei instrucţiuni wait (), acesta 
este considerat de către maşina virtuală ca fiind suspendat şi nu i se alocă timp 
de execuţie pe procesor până în momentul în care este trezit printr-un apel al 
lui notify () dintr-un alt fir de execuţie. Apelul lui notify () trebuie făcut 
dintr-un alt fir, deoarece firul curent este suspendat, deci nu are cum să apeleze 
notify (). Apelul lui notify () va informa un singur fir de execuţie aflat în 
aşteptare de faptul că starea obiectului s-a modificat, încheind astfel aşteptarea 
din cadrul lui wait (). 

Metoda wait () are şi două variaţiuni uşor diferite. Prima versiune ac- 
ceptă un parametru de tip long, interpretat ca perioadă de expirare a aşteptării 
(timeout) măsurată în milisecunde. A doua variantă acceptă doi parametri, in- 
terpretaţi tot ca o perioadă de expirare (în milisecunde şi nanosecunde) a aştep- 
tării. Aceste variante sunt folosite atunci când nu dorim să aşteptăm la infinit 
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producerea unui anumit eveniment. Dacă dorim să renunţăm la aşteptare după 
o anumită perioadă, va trebui să folosim una dintre metodele: 


wait ( long miliseconds ) 
wait ( long miliseconds , int nanoseconds ) 


Un mic inconvenient este dat de faptul că aceste metode nu oferă o modali- 
tate prin care să determinăm dacă apelul lui wait () s-a încheiat printr-un apel 
de notify() sau prin expirare (timeout). Totuşi această problemă poate fi 
uşor rezolvată, deoarece putem verifica din nou condiţia de aşteptare şi timpul 
curent pentru a determina care dintre cele două evenimente s-a produs. 

Metodele wait () şi notify () pot fi apelate doar dacă firul de execuţie 
curent deţine monitorul obiectului pe care sunt apelate. Vom detalia acest aspect 
în paragrafele următoare. 


8.4.3 Exemplu de coordonare a firelor de execuţie: problema 
consumator-producător 


Exemplul clasic de coordonare a firelor de execuţie, folosit în majoritatea 
lucărilor de programare este problema bufferului de capacitate limitată. În vari- 
anta sa cea mai simplă, această problemă presupune că se utilizează un buffer 
(zonă tampon de memorie) pentru a comunica între două fire de execuţie sau 
procese (în multe sisteme de operare, bufferele de comunicare între procese au 
dimensiune fixă). Există un fir de execuţie care scrie date în buffer şi un altul 
care preia datele din buffer spre a fi prelucrate mai departe. Pentru ca bufferul să 
funcţioneze corect, trebuie ca firul care scrie şi cel care citeşte să fie coordonate, 
astfel încât: 


e firul care scrie poate să adauge date în buffer până când acesta se umple, 
moment în care firul este suspendat; 


e după ce firul care citeşte extrage date din bufferul plin, notifică firul care 
scrie asupra stării modificate a bufferului, care este activat şi i se permite 
să reia scrierea; 


e firul care citeşte poate să extragă date din buffer până când acesta se 
goleşte, moment în care firul este suspendat; 


e când firul care scrie adaugă date la bufferul gol, firul care citeşte este 
notificat asupra stării modificate a bufferului, este activat şi i se permite 
să reia citirea. 
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Vom prezenta în continuare trei clase Java care rezolvă problema bufferului de 
capacitate limitată. Acestea sunt denumite în mod clasic Producer (clasa 
care implementează firul de execuţie care scrie în buffer), Consumer (clasa 
care implementează firul de execuţie care citeşte din buffer) şi Buf fer (clasa 
centrală, care oferă metode pentru a adăuga şi citi date în şi din buffer). 

Să începem cu clasa Producer, care este extrem de simplă: 


public class Producer implements Runnable 
{ 


private Buffer buffer; 


{ 
this.buffer = buffer ; 


} 


l 
2 
3 
4 
s public Producer(Buffer buffer) 
6 
7 
8 
9 


o public void run() 


uo è f{ 


12 for (int i=0; i<250; i++) 


13 { 
14 buffer.put((char)("'A' + (i %26))); 


Clasa Producer implementează interfaţa Runnable, ceea ce reprezintă 
un indiciu al faptului că va rula pe un fir de execuţie separat. În momentul 
în care se apelează metoda run () a clasei Producer, se va scrie rapid în 
Buffer o succesiune de 250 de caractere. Dacă clasa Buffer nu este capa- 
bilă să reţină toate cele 250 de caractere, rămâne în responsabilitatea metodei 
put () abufferului să realizeze coordonarea adecvată a firelor de execuţie (vom 
vedea imediat cum). 

Clasa Consumer este la fel de simplă ca şi clasa Producer: 


public class Consumer implements Runnable 
{ 


private Buffer buffer; 


{ 
buffer = b; 


) 


l 
2 
3 
4 
s public Consumer( Buffer b) 
6 
7 
8 
9 


0 public void run() 
u | 
12 for (int i=0; i<250; i++) 


13 | 
14 System . out. priniln (buffer. get()); 
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Ca şi în cazul clasei Producer, clasa Consumer implementează de aseme- 
nea interfaţa Runnable. Metoda ei run () citeşte cu lăcomie 250 de caractere 
din Buffer. În situaţia în care Consumer încearcă să preia caractere dintr-un 
Buffer gol, metoda get () a clasei Buffer este responsabilă de a coordona 
firul de execuţie al consumatorului. 

Iată acum care este codul pentru clasa Buffer. Două dintre metodele ei, 
get () şi put (), au fost deja amintite. 


Listing 8.7: Clasa Buffer 
public class Buffer 
{ 


1 
2 

3 private char[] buf ;//retine elementele din buffer 
4 private int last ; //ultima pozitie ocupata 

5 

6  /*xx* Construieste un buffer cu size elemente */ 

7 public Buffer(int size) 

s { 

9 buf = new char[size]; 

10 last = 0; 


uo o} 


3 /xx Intoarce true daca bufferul e plin.*/ 
4 public boolean isFull () 


5o f 


16 return (last == buf.length ); 


7) 


9  /x* Intoarce true daca bujfferul e gol. */ 
2 public boolean isEmpty() 
2a f 


22 return (last == 0); 
2 ë } 


2  /*x* Adauga caracterul c la buffer. Daca bufferul 


26 x este plin, atunci se asteapta pana cand se obtine 
27 x o notificare de la metoda get(). */ 

2 public synchronized void put(char c) 

2 f 

30 while(isFull()) 

31 í 

32 try 

33 í 

34 wait (); 
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36 catch (InterruptedException e) { } 

37 ) 

38 buf[last++] = c; 

39 // anunta firul consumator ca bufferul nu mai e gol 
40 notify (); 


Al ) 


4 /xx* Extrage primul caracter din Buffer. Daca bufferul 
44 x este gol, se asteapta pana cand se obtine o notificare 
45 x de la metoda get(). */ 
4 public synchronized char get() 
47 
{ 


48 while (isEmpty ()) 

49 { 

50 try 

51 { 

52 wait (); 

53 

54 catch (InterruptedException e) { } 

55 } 

56 char c =buf[0]; 

57 // deplaseaza elementele din buffer la stanga 
58 System . arraycopy (buf, 1, buf, 0, —— last); 

59 // anunta firul producator ca bufferul nu mai e plin 
60 notify (); 

6l return c; 


Observație: Cititorii atenți, aflați la prima confruntare cu metodele wait () 
şi notify () ar putea observa o contradicție. S-a menţionat deja faptul că 
pentru a putea apela metodele wait () şi notify (), firul de execuţie trebuie 
să deţină monitorul obiectului. Astfel, dacă un fir de execuţie obţine monitorul 
unui obiect şi intră apoi în aşteptare printr-un apel al metodei wait (), cum 
va putea alt fir de execuţie să obţină monitorul obiectului pentru a putea no- 
tifica primul fir? Oare monitorul nu este încă în posesia firului care aşteaptă, 
împiedicând astfel al doilea fir în a-l obţine? Răspunsul la acest aparent para- 
dox este dat de modul în care este implementată în Java metoda wait (): 
aceasta eliberează temporar monitorul după ce a fost apelată, şi obţine din nou 
monitorul înainte de a se încheia. Astfel, metoda wait () permite şi altor 
fire de execuţie să obţină monitorul obiectului şi (eventual) să apeleze metoda 
notify (). 

Clasa Buffer este doar o simplă zonă tampon de memorie şi nimic mai 
mult. Se pot adăuga elemente în buffer, folosind metoda put () şi se pot ex- 
trage elemente din buffer folosind metoda get (). 
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Observaţi modul în care s-au utilizat wait () şi noti fy () în aceste metode. 

În cadrul metodei put (), atâta timp cât bufferul este plin, se intră în aşteptare. 
Astfel, nu se vor mai putea adăuga noi elemente în buffer până în momentul 
în care firul producător nu este notificat (la linia 60) de către consumator că 
au fost extrase elemente din buffer. Apelul metodei notify () din finalul 
metodei get () are rolul de a activa firul de execuţie care aşteaptă în cadrul 
metodei put () la linia 34 (dacă acesta există), permițându-i astfel să adauge 
un nou caracter în Buffer. Un raţionament absolut similar este valabil şi pen- 
tru metoda get (), în care se aşteaptă cât timp bufferul este gol, după care se 
extrage un caracter şi se notifică noua stare a bufferului. 


Clasa Buf ferTest de mai jos, construieşte un Buffer, după care porneşte 
pe fire de execuţie separate producătorul şi consumatorul: 


public class TestBuffer 
{ 
public static void main(String args []) 


new Thread( new Producer( b ) ). start () ; 
new Thread ( new Consumer( b ) ).start(); 


l 
2 
3 
a d 
5 Buffer b = new Buffer( 50); 
6 
7 
8 o} 

9 


} 


Rezultatul afisat la consolă (în cadrul clasei Consumer) confirmă faptul că 
firele de execuție au fost corect coordonate: 


ABCDEFGHIJKLMNOPOQORSTUVWXYZ 
ABCDEFGHIJKLMNOPQORSTUVWXYZA 
B (DE E CHA I-J KLIMNO P OTR S TUWA TA A.B 
C D-EFGH’EIJKLMNOPORSTUVWXYZABC 
DEFGHIJKLMNOPQORSTUVWXYZABCD 
EFGHIJKLMNOPORSTUVWXYZABCDE 
ES HAHI IPL UNOPORS TUVW AA BOOD EF 
GHIJKLMNOPQORSTUVW—XYZABCDEFG 
EIJK A MN O POR e LU VW x i Z. ABC DEF 


Implementarea metodei get () din clasa Buffer nu este foarte eficientă. 
La fiecare apel al acestei metode, toate celelalte caractere din buffer trebuie de- 
plasate către stânga. O problemă de la finalul acestui capitol propune o imple- 
mentare mai eficientă a clasei Buffer folosind o coadă alocată static (detalii 
despre cozi în cel de-al doilea volum, dedicat structurilor de date şi algorit- 
milor). 
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8.4.4  Deţinerea monitoarelor 


Există o restricţie importantă în folosirea metodelor wait () şinotify (): 
aceste metode pot fi apelate doar dacă firul de execuţie curent deţine monitorul 
obiectului. În multe situaţii, metodele wait () şi notify() sunt apelate în 
cadrul unor metode sincronizate (deținerea monitorului fiind astfel asigurată), 
ca în exemplul de mai jos: 


public synchronized void method () 
{ 


while (!condition) 


l 
2 
3 
4 
s {d 
6 
7 
8 
9 


) 


În situaţia de mai sus, modificatorul synchronized ne asigură de faptul 
că firul de execuţie care apelează wait () deţine deja monitorul în momentul 
apelului. 

Ce se întâmplă însă dacă se încearcă apelul wait () sau notify () fără 
a deţine monitorul obiectului (de exemplu, în cadrul unei metode nesincroniza- 
te)? Compilatorul nu poate să îşi dea seama dacă există un apel ilegal (fără a 
deţine monitorul) al acestor metode (de exemplu se poate ca o metodă nesin- 
cronizată să apeleze wait (), dar această metodă să fie apelată de o metodă 
sincronizată). Aşadar, singura posibilitate este ca, în timpul execuţiei, dacă se 
întâlneşte un apel al metodelor wait () sau notify () fără a deţine monitorul 
obiectului să se genereze o excepţie. Această excepţie se numeşte Illegal- 
MonitorStateEkxception şi este aruncată de maşina virtuală Java ori de 
câte ori întâlneşte un apel ilegal al metodelor wait () sau notify (). Clasa 
MonitorTest de mai jos evidenţiază ce se petrece în momentul în care se 
apelează metoda wait () fără a fi deţinut în prealabil monitorul clasei: 


ı public class MonitorTest 
2 { 
public static void main(String [|] args) 


{ 


3 

4 

5 MonitorTest mt = new MonitorTest(); 
6 mt.method (); 
n 

8 

9 


) 


public void method() 


CO | 
LI try 


12 { 


13 wait (); 
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14 } 


15 catch (InterruptedException e) 


Dacă veți încerca să executați această clasă, veți primi următorul mesaj: 


Exception in thread "main" 
java.lang.IllegalMonitorStateException 
at java.lang.Object.wait (Native Method) 
at java.lang.Object.wait (Object. java:420) 
at MonitorTest.method(MonitorTest.java:13) 
at MonitorTest.main (MonitorTest.java:6) 


Pentru a evita o astfel de excepţie, este necesar ca de fiecare dată când apelaţi 
metoda wait () pe un obiect să vă asiguraţi că firul de execuţie deţine moni- 
torul acelui obiect. 


8.4.5 Utilizarea instrucţiunii synchronized 


Instrucţiunea synchronized poate fi şi ea folosită pentru a realiza co- 
ordonarea firelor de execuţie. În cele mai multe cazuri utilizarea metodelor 
sincronizate este suficientă, şi datorită faptului că sintaxa lor este mai simplă 
ele sunt de preferat instrucţiunii synchronized. Există totuşi două situaţii 
în care utilizarea metodelor sincronizate nu este de dorit, sau nu poate rezolva 
problema. 

Dacă metoda care conţine un wait () sau notify() este foarte lungă 
(şi necesită un timp de execuţie semnificativ) este preferabil să se sincronizeze 
doar secvenţa de cod care este strict necesară pentru a menţine consistenţa la 
concurenţă. 

Adeseori este necesar să coordonăm metode din obiecte diferite. În această 
situaţie, utilizarea de metode sincronizate nu are nici un sens, deoarece apelul 
lui notify () din cadrul unei metode sincronizate a unui obiect nu are nici un 
efect asupra firului de execuţie aflat în aşteptare în cadrul unui wait () peun 
alt obiect (metodele obţin monitoare distincte)! 

Să presupunem de exemplu că avem la dispoziţie o clasă simplă Buf fer1 
identică din punct de vedere al interfeţei cu clasa Buf fer din paragraful 8.4.3, 
dar care a fost concepută şi scrisă pentru a funcţiona corect pe un singur fir de 
execuţie: 
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public class Bufferi 
{ 


1 
2 

3 private char[] buf; //retine elementele din buffer 
4 private int last; //ultima pozitie ocupata 

5 

6  /x* Construieste un buffer cu size elemente */ 

7 public Bufferl(int size) 

s { 

9 buf = new char|size|; 

10 last = 0; 


C 


3 /xx Intoarce true daca bufferul e plin.*/ 
4 public boolean isFull() 

5 4 

16 return (last == buf.length ); 


17 } 


9 /xx» Intoarce true daca bufferul e gol. */ 
2 public boolean isEmpty () 

a f 

22 return (last == 0); 

23) 


25 /xx Adauga caracterul c la buffer. */ 
2 public synchronized void put(char c) 


27 f 

28 buf[last++] = c; 

2) 

30 

31 /xx* Extrage primul caracter din Buffer. */ 
3 public synchronized char get() 

3 ë f 

34 char c = buf[0]; 

35 // deplaseaza elementele din buffer la stanga 
36 System .arraycopy (buf, 1, buf, 0, —— last); 
37 return CcC; 

33] 

39 ) 


Observaţi că, spre deosebire de clasa Buf fer din paragraful 8.4.3, această 
clasă nu conţine nici o linie de cod pentru a coordona în vreun fel producătorul 
şi consumatorul. Rămâne astfel în sarcina producătorului şi a consumatorului să 
îşi coordoneze accesul la buffer. Având în vedere că producătorul şi consuma- 
torul sunt implementate de clase diferite, utilizarea metodelor sincronizate în 
vederea coordonării nu este posibilă. Coordonarea ar trebui să se facă folosind 
wait () şi notify() pe acelaşi obiect. Care obiect? Chiar instanţa clasei 
Bufferl. Codul de mai jos descrie clasa Producer, care este o variantă 
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modificată a clasei Producer: 


public class Producer! implements Runnable 
{ 


private Bufferl buffer; 


{ 
this.buffer = buffer ; 


l 
2 
3 
4 
s public Producerl(Bufferi buffer) 
6 
pi 
s o } 

9 


o public void run() 


uo f 


12 for (int i=0; i<250; i++) 
13 í 
14 synchronized ( buffer ) 
15 
{ 
16 while ( buffer.isFull() ) 
17 { 
18 try 
19 
20 buffer.wait() ; 
2l } 
22 catch ( InterruptedException e ) 
23 {} 
24 } 
25 buffer.put((char)( °A? + (i %26))); 
26 buffer.notify () ; 
27 } 
28 } 
20 } 


Diferența față de clasa Producer apare la metoda run (), care conține 
cod suplimentar pentru a realiza sincronizarea cu consumatorul. In primul rând, 
la linia 14 se solicită monitorul bufferului, folosind instrucțiunea 


synchronized (buffer) 


{ 
) 


Instrucţiunea synchronized este utilizată în acest caz din două motive. 
În primul rând, trebuie asigurată consistenţa la concurenţă, prin evitarea situaţiei 
de a se scrie şi citi în buffer în acelaşi timp. În al doilea rând, instrucţiunea 
synchronized garantează obţinerea monitorului obiectului buffer, pe care 
se va putea apoi apela wait () în cazul în care bufferul este plin (linia 20), 
respectiv notify () după ce s-a citit din buffer (linia 26). Remarcaţi faptul că 
wait () şi notify () au fost apelate în conjuncţie cu obiectul buffer: 
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buffer.wait() 
buffer .notify () 


deoarece coordonarea se face utilizând monitorul bufferului. 
Implementarea consumatorului este similară cu cea a producătorului şi este 
realizată de clasa Consumer de mai jos: 


public class Consumer! implements Runnable 
{ 


private Bufferl buffer; 


{ 
) 


l 
2 
3 
4 
s public Consumerl (Bufferl buffer) 
6 
7 this.buffer = buffer ; 

8 

9 


w0 public void run() 


uo è f{ 


12 for (int i=0; i<250; i++) 
13 { 
14 synchronized ( buffer ) 
I5 
( 
16 while ( buffer.isEmpty() ) 
17 { 
18 try 
19 { 
20 buffer. wait () ; 
21 } 
22 catch ( InterruptedException e ) 
23 () 
24 } 
25 System.out.print(buffer.get() + "—"); 
26 buffer.notify () ; 
27 } 
28 } 
>») 
30 ) 


Pentru a testa noua rezolvare a problemei bufferului, am creat clasa Test- 
Buffer1, absolut similară clasei TestBuffer: 


public class TestBufferi 
{ 


) 


l 

2 

3 public static void main(String args []) 

aod 

5 Bufferl b = new Bufferl (2 ) ; 

6 new Thread ( new Producerl( b ) ).start() ; 
7 new Thread ( new Consumerl( b ) ).start() ; 
8 

9 


) 
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La execuţia acestei clase, se va afişa aceeaşi secvenţă de caractere ca şi la 
rezolvarea precedentă, ceea ce dovedeşte că şi această abordare este viabilă. 


8.4.6 Un alt exemplu: consumatori şi producători multipli 


Este posibil ca mai multe fire de execuţie să fie în aşteptare (wait ()) pe 
acelaşi obiect. Această situaţie poate să apară dacă mai multe fire de execuţie 
aşteaptă apariţia aceluiaşi eveniment, sau dacă există mai multe fire de exe- 
cuţie care partajează o resursă unică. Să luăm din nou exemplul clasei Buffer 
prezentată în secţiunea 8.4.3. Bufferul era utilizat de către un singur producător 
şi un singur consumator. Ce s-ar petrece însă, dacă ar exista mai mulţi pro- 
ducători? Dacă bufferul se umple, ar putea exista mai mulţi producători care să 
încerce să adauge date în Buf fer. Toţi aceştia ar sta blocaţi în cadrul metodei 
put () , aşteptând ca un consumator să elibereze ceva spaţiu în Buffer. 


În momentul în care se apelează notify () pe un obiect, pot exista zero, 
unul sau mai multe fire de execuţie blocate în cadrul unui wait () pe acel 
obiect. Dacă nu există nici un fir de execuţie în aşteptare, apelul metodei 
notify () nu are nici un efect. Dacă un singur fir de execuţie este în aşteptare, 
acesta va fi notificat şi va începe să aştepte eliberarea monitorului de către firul 
de execuţie care a apelat notify (). Dacă există două sau mai multe fire de 
execuţie în aşteptare, maşina virtuală Java va alege un singur fir de execuţie, pe 
care îl va notifica. 


Cum se face alegerea firului de execuţie care va fi notificat? Situaţia este 
aceeaşi cu cea în care mai multe fire de execuţie aşteaptă eliberarea unui mo- 
nitor: comportamentul nu este specificat. Totuşi, implementările curente ale 
maşinii virtuale Java, folosesc un algoritm bine definit. Astfel, maşina virtuală 
de pe Solaris va alege firul de execuţie cu prioritatea cea mai mare şi îl va 
notifica. Dacă există mai mult de un fir de execuţie cu aceeaşi prioritate, va fi 
ales firul care a intrat primul în wait (). Situaţia în cazul maşinii virtuale de pe 
Windows este ceva mai complicată, deoarece în acest caz se folosesc algoritmii 
de planificare specifici sistemului de operare. 


Astfel, deşi se poate prezice care dintre fire de execuţie va fi notificat, nu 
trebuie în nici un caz să scriem cod care să se bazeze pe astfel de deducţii. 
Singurul fapt pe care ne putem baza este că doar un singur fir de execuţie va 
fi notificat la apelul lui notify () (dacă există cel puţin un fir de execuţie în 
aşteptare). 
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Utilizarea metodei notifyAll () 


Există situaţii în care vom dori notificarea fiecărui fir de execuţie care aş- 
teaptă la un moment dat pe un obiect. Interfața clasei Object oferă o metodă 
care face exact acest lucru: notifyAll (). În timp ce metoda notify () 
trezeşte un singur fir de execuţie, metoda notifyAll () va trezi toate firele 
de execuţie aflate în acel moment în aşteptare pe monitorul obiectului. 

Un exemplu concret în care este necesară utilizarea lui notifyAll () îl 
constituie problema bufferului cu producători şi consumatori multipli. În ver- 
siunea prezentată în cadrul paragrafului 8.4.3, clasa Buffer utiliza metoda 
notify() pentru a trimite o notificare unui singur fir de execuţie aflat în 
aşteptare pe un buffer plin sau gol. Totuşi, în practică, nu există nici o garanţie 
că doar un singur fir de execuţie se află în aşteptare, deoarece pot exista con- 
sumatori şi producători multipli. Iată o altă variantă a clasei Buf fer denumită 
(din lipsă de imaginaţie) Buffer2, care foloseşte notifyAll () şi este ca- 
pabilă să coordoneze consumatori şi producători multipli. 


Listing 8.8: Clasa Buffer? 
public class Buffer? 
{ 


l 
2 
3 private char[] buf; //contine elementele din buffer 

4 private int last = 0; // ultima pozitie ocupata 

s private int writersWaiting = 0; //nr. fire ce asteapta in put() 
6 private int readersWaiting = 0; //nr. fire ce asteapta in get() 
7 
8 
9 


/*xx* Construieste un buffer cu size elemente */ 
public Buffer2(int size) 

C | 

T buf = new char[size]; 


2) 


4  /x* Intoarce true daca bufferul e plin.+*/ 
5 public boolean isFull() 

6 | 

17 return (last == buf. length ); 


8) 


2 /xx» Intoarce true daca bufferul e gol. */ 
2 public boolean isEmpty () 


2 f 
23 return (last == 0); 
24 } 


2  /*xx* Adauga caracterul c la buffer. Daca bufferul este plin, 
27 x atunci se incrementeaza <code>writers Waiting </code> 
28 x si se asteapta pana cand se obtine 
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x o notificare de la metoda get(). */ 


public synchronized void put(char c) 


{ 


while( isFull() ) 
{ 
try 
{ 
writersWaiting ++; 
wait (); 
) 
catch ( InterruptedException e ) 
4] 
writersWaiting——; 
) 
buf[last++] = c; 
if (readersWaiting > 0) 
{ 
notifyAll (); 


/xx Extrage primul caracter din Buffer. Daca bufferul 


x este gol, se incrementeaza readersWaiting si se 
* asteapta pana cand se obtine o notificare 
x de la metoda get(). */ 


public synchronized char get() 


{ 


while (isEmpty ()) 
{ 
try 
{ 
readersWaiting ++ ; 
wait (); 
) 


catch (InterruptedException e) 


(] 


readersWaiting——; 


) 

char c = buf[o]; 

System .arraycopy(buf, 1, buf, 0, —— last); 
if (writersWaiting > 0) 


{ 
} 


return CcC; 


notifyAll (); 


După cum ați observat, metodele get () şi put () au fost făcute mai in- 


teligente. Ele verifică mai întâi dacă este necesară vreo notificare (liniile 44 şi 
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69), după care utilizează notifyAll () pentru a difuza notificarea la toate 
firele de execuţie aflate în aşteptare. 


8.4.7 Utilizarea lui InterruptedException 


Aţi observat cu siguranţă utilizarea consecventă de-a lungul acestui capitol 
a clasei InterruptedException. Dacă veţi examina modul în care este 
declarată metoda wait () în clasa Object, veţi înţelege de ce: 


public final void wait() throws InterruptedException 


wait () declară că ar putea să arunce o InterruptedException. A- 
ceastă excepţie se generează atunci când se apelează metoda interrupt () a 
clasei Thread. Limbajul Java oferă posibilitatea de a întrerupe aşteptarea de 
orice natură (wait, sleep) a unui fir de execuţie prin generarea unei excepţii de 
tipul InterruptedException într-un alt fir de execuţie, folosind metoda 
interrupt (). Această metodă este utilizată pentru a trezi firele de execuţie 
aflate în aşteptare în cadrului unui wait (), sleep () sau a altor operaţii (de 
exemplu citire de la un socket). 


Rezumat 


Este deosebit de important să distingem situaţiile în care este cazul să se 
utilizeze mai multe fire de execuţie de situaţiile în care trebuie să le evităm. Cel 
mai important motiv pentru utilizarea firelor de execuţie este necesitatea de a 
realiza mai multe operaţii, a căror rulare amalgamată va produce o utilizare mai 
eficientă a maşinii de calcul (incluzând aici şi posibilitatea de a distribui opera- 
tiile pe mai multe procesoare) sau va îmbunătăţi interacţiunea cu utilizatorul. 

Totuşi, utilizarea firelor de execuţie are şi dezavantaje, cum ar fi scăderea 
vitezei din cauza aşteptării după resurse partajate şi creşterea utilizării proce- 
sorului pentru a le gestiona. 

Un alt avantaj important al firelor de execuţie este că, aşa cum am menţionat 
la începutul capitolului, ele înlocuiesc schimbările de context mari consuma- 
toare de resurse generate de procese (de ordinul miilor de instrucțiuni) cu schim- 
bări de context rapide (de ordinul sutelor de instrucţiuni). Având în vedere fap- 
tul că toate firele de execuţie din cadrul unui proces partajează aceeaşi zonă 
de memorie, o schimbare de context nu implică în acest caz decât modificarea 
punctului de execuţie şi a variabilelor locale. Pe de altă parte, o schimbare de 
context în cazul proceselor implică interschimbarea întregului spaţiu de memo- 
rie. 
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Firele de execuţie reprezintă o lume nouă, iar a învăţa să le utilizezi este 
echivalent cu asimilarea unui nou limbaj de programare. Una dintre principalele 
dificultăţi legată de firele de execuţie este dată de faptul că mai multe fire pot 
partaja aceleaşi resurse, cum ar fi atributele unui obiect, iar în acest caz trebuie 
să vă asiguraţi că nu se poate întâmpla ca mai multe fire să încerce să acceseze 
resursa în acelaşi timp. Aceasta presupune utilizarea atentă a cuvântului cheie 
synchronized, care este o unealtă extrem de utilă, dar care trebuie înţeleasă 
în profunzime, deoarece poate să provoace situaţii subtile de blocaj circular. 

Capitolul de faţă este departe de a epuiza toate subiectele legate de firele 
de execuţie. Nu am vorbit aici despre prioritatea firelor de execuţie, despre 
grupuri de fire de execuţie şi clasa ThreadGroup sau despre fire de execuţie 
daemon. Veţi găsi informaţii despre toate aceste subiecte în excelenta carte a lui 
Bruce Eckel, Thinking in Java (vezi [Eckel]). Pentru o prezentare mai avansată 
a firelor de execuţie, consultaţi Concurrent Programming in Java, de Doug Lea, 
Addison-Wesley, 1997. 


Noţiuni fundamentale 


blocaj circular (deadlock): situaţie în care două sau mai multe fire de exe- 
cuţie aşteaptă eliberarea a două sau mai multe resurse pe care le deţin reciproc 
(deci nu vor fi niciodată eliberate). 

coordonare: termen utilizat pentru a desemna dirijarea execuţiei a două sau 
mai multe fire de execuţie folosind metodele wait () şi notify(). 

fir de execuţie (thread) : un flux de execuţie în cadrul unui proces. 

inconsistenţă la concurenţă (race condition): eroare de programare care 
cauzează comportamentul eronat sau imprevizibil al unui program. Mai exact, 
această eroare apare în cazul în care rezultatul unei operaţii depinde de factori 
temporali imprevizibili, cum ar fi ordinea în care s-a alocat timp pentru execuţia 
firelor de execuţie. 

monitor: obiect special utilizat pentru a realiza excluderea reciprocă a unui 
grup de metode. 

partajare de resurse: două sau mai multe fire de execuţie au acces la ace- 
Jeaşi resurse (de exemplu, la atributele unui obiect). 

proces: program de sine stătător, care dispune de propriul lui spaţiu de 
adrese. 

serializare: constă în a impune accesul unui singur fir de execuţie la un 
moment dat la o resursă în acelaşi timp. 

sincronizare: reprezintă coordonarea unor evenimente astfel încât doar un 
anumit eveniment se produce la un moment dat. 
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Erori frecvente 


1. Cea mai frecventă eroare este că programatorul nu este conştient că rulează 
într-un mediu multithreaded (de exemplu în cazul unui servlet Java) şi 
scrie cod ignorând complet inconsistenţele la concurenţă. 


2. Mulţi începători definesc firele de execuţie corect, dar uită să le pornească. 


3. Din cauza grabei sau a lipsei de experienţă, adeseori nu sunt detectate 
secvențele de cod care pot conduce la inconsistenţă la concurenţă. 


4. Nu este suficient să sincronizăm modificatorii unui atribut pentru a obţine 
consistenţa la concurenţă. Trebuie sincronizate şi secvențele de cod care 
accesează acel atribut. 


5. Apelarea metodei wait () pe alt obiect decât cel pe care s-a făcut sin- 
cronizarea va genera o IllegalMonitorStateException. 


6. Apelul lui notify () pe un obiect pentru a notifica un fir de execuţie 
care se află în aşteptare pe un alt obiect, nu va avea nici un efect. 


Exerciţii 
Pe scurt 


1. Care este diferenţa între fire de execuţie şi procese? 
2. Ce interfaţă Java trebuie implementată de către firele de execuţie? 
3. Ce metodă este apelată pentru a porni un fir de execuţie? 


4. Ce metodă este apelată de către maşina virtuală la pornirea unui fir de 
execuţie? 


5. Când trebuie utilizat cuvântul cheie synchronized? 


6. Când este de preferat instrucţiunea synchronized() metodelor sin- 
cronizate? 


7. Ce este un monitor? 


8. Care este diferenţa între coordonarea şi sincronizarea firelor de execuţie? 
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In practică 


1. Creați două clase derivate din Thread. Metoda run () a primei clase 
obţine o referinţă către cea de-a doua clasă, după care apelează wait () 
pe acest obiect. Metoda run () a celei de-a doua clase va apela metoda 
notifyAll () pentru primul fir după câteva secunde, astfel încât acesta 
să poată afişa un mesaj. 


2. Construiţi o clasă Account Test care să pună în evidenţă problemele de 
inconsistenţă la concurenţă pe care le are clasa Account din paragraful 
8.3.2. 


3. Modul în care este implementată metoda get () în clasa Buffer din 
paragraful 8.4.3 este ineficient, deoarece necesită deplasarea tuturor ele- 
mentelor din buffer către stânga (având astfel complexitatea O(n)). Mo- 
dificaţi clasa Buffer pentru a reţine elementele sub forma unei cozi 
(detalii despre cozi în volumul al doilea, dedicat structurilor de date şi al- 
goritmilor) astfel încât metodele put () şi get () să aibă complexitatea 


O(). 


4. Clasele BufferI, Consumer şi Producer] din paragraful 8.4.5 
constituie o implementare a problemei bufferului cu un singur producă- 
tor şi un singur consumator în care sincronizarea şi coordonarea firelor de 
execuţie este făcută în cadrul producătorului şi consumatorului. Adaptaţi 
această soluţie pentru a funcţiona şi în cazul problemei bufferului cu pro- 
ducători şi consumatori multipli fără a modifica clasa Buffer! 


Indicaţie 

Se vor adăuga două atribute statice în cadrul claselor Producer şi Con- 
sumer, writersWaiting respectiv readersWaiting, care vor 
fi incrementate şi decrementate de câte ori un fir întră în aşteptare sau 
este trezit. Pentru a asigura consistenţa la concurenţă, trebuie să se de- 
finească metode statice sincronizate care să incrementeze respectiv să 
decrementeze aceste variabile. Coordonarea consumatorilor şi producă- 
torilor se va face utilizând wait () şi notifyAll (),care vor fi apelate 
pe monitorul clasei Buf fer (ca în paragraful 8.4.5). 


5. Problema damelor constă în a aşeza n dame pe o tablă de şah de dimen- 
siune n x n, astfel încât acestea să nu se atace între ele. Rezolvaţi această 
problemă astfel încât pentru fiecare posibilitate de a aşeza o damă pe o 
coloană în cadrul unei linii să se pornească un fir de execuţie separat 
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(practic, se vor încerca în paralel toate variantele de a aşeza dama pe o 
anumită line)! 


Proiecte de programare 


1. Scrieţi o variantă generalizată a clasei Buf fer, numită MessageQueue, 
care permite în plus comunicarea între producători şi consumatori pe anu- 
mite “canale” independente. Aceasta înseamnă că clasa MessageQueue 
va putea fi utilizată drept suport de comunicare între categorii distincte 
de fire de execuţie. De exemplu, un canal al clasei MessageQueue 
(să-l numim LogChanne 1) va putea fi folosit de către fire de execuţie 
(producători) care doresc să scrie mesaje de log. Pot exista mai mulţi 
consumatori care sunt înscrişi la acest canal şi preiau mesajele din coadă 
pentru a le prelucra într-un anumit mod. De exemplu, un consumator 
poate scrie mesajele de log într-o fereastră utilizator, în timp ce altul le 
va putea scrie într-un fişier text. Mai precis, clasa MessageQueue va 
trebui să implementeze interfaţa IMessageQueue de mai jos: 


ı public interface IMessageQueue 

2 { 

3 /x»x» Creaza un canal nou cu numele name. 
4 x Se initializeaza o coada noua de 

5 * asteptare pentru a stoca mesajele 

6 x care vin pe acest canal. 

7 */ 

s public Channel createChannel( String name ) ; 
9 


0  /*xx* Se apeleaza pentru a inchide un canal */ 
ı public void destroyChannel ( Channel channel ) ; 


3 /*xx* Asteapta aparitia urmatorului mesaj, dupa care 
14 x intoarce mesajul respectiv. 
15 * / 


6 public Object getMessage( Channel channel ) ; 


8  /*x* Adauga un mesaj in coada pentru un anumit canal. */ 
9 public void putMessage ( Channel channel, Object message ) ; 
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Digitized by Google 


A. Mediul Java şi uneltele ajutătoare 


Geniul nu se mulţumeşte să 
constate. El oferă soluţii. 


Robert Graves 
Scopul acestei anexe este de a veni în ajutorul celor care încep să pro- 


grameze în Java şi a le indica cele mai adecvate unelte, necesare pentru a începe 
dezvoltarea de aplicaţii Java. In cadrul acestei anexe vom prezenta: 


e Cele mai populare editoare şi medii integrate Java; 
e Cum se instalează Java pe Windows şi Linux; 
e Cum se pot compila automat aplicaţiile Java folosind ant ; 


e Site-uri web care conţin informaţii utile oricărui dezvoltator Java. 


A.l Editarea codului sursă 


Pentru editarea codului sursă al unui program Java este suficient un sim- 
plu editor de fişiere text, cum ar fi Notepad (pe Windows) sau pico (pe Linux). 
Totuşi, majoritatea programatorilor doresc facilităţi superioare celor pe care le 
poate oferi un astfel de editor de fişiere text. Există două variante în această situ- 
aţie: utilizarea unor editoare mai performante (paragraful A.1.1) sau utilizarea 
unor medii integrate de dezvoltare a aplicaţiilor Java (paragraful A.1.2). 


A.1.1 Editoare 


Cea mai importantă facilitate oferită de următoarele editoare este "syntax 
highlighting (colorarea textului în funcţie de ceea ce reprezintă - de exemplu un 
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comentariu, numele unei clase, un cuvânt rezervat etc.). De asemenea, primele 
două editoare menţionate în tabelul de mai jos oferă facilităţi suplimentare cum 
ar fi compilarea şi execuţia codului, organizarea fişierelor în proiecte, interfaţă 
pentru ant (vezi paragraful A.3.1) etc. Puteţi afla mai multe despre fiecare 
editor în parte vizitând situl asociat, furnizat de tabelul de mai jos. 


OSTIDR 


jEdit | jedit.org | J2SDK 1.3 şi | Este scris în Java şi rulează pe orice 
1.4 sistem care dispune de Java 2 versi- 
unile 1.3 sau 1.4 (recomandat) 


Jext jext.org | J2SDK 1.3 Versiunea pentru Windows include 
un mediu Java 


NEdit Este scris în C şi este foarte rapid 


A.1.2 Medii integrate IDE (Integrated Development Environ- 
ments) 


Mediile integrate IDE oferă mult mai multe facilităţi decât un simplu edi- 
tor. Practic, folosind un mediu IDE, programatorului îi sunt puse la dispoziţie 
toate elementele de care are nevoie pentru a crea aplicaţii Java profesionale: 
debugger-e pentru executarea pas cu pas a aplicaţiilor, modalităţi de a vedea în 
orice moment ierarhia de clase şi metode existente în cadrul unui proiect, com- 
pletarea automată a codului (code completion), compilare incrementală (codul 
este compilat în timp ce îl scrieţi) etc. Dintre toate aceste produse, noi reco- 
mandăm cu căldură mediul Eclipse care este uşor de utilizat şi dispune de o 
veritabilă armată de facilităţi deosebit de utile. 
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Aplicaţie OSTIDR 


Eclipse eclipse.org J2SDK 1.3 Inclus şi în pro- 
dusele IBM Visu- 
alAge 

Forte for Java | forte.sun.com/ffj J2SDK 1.3 Bazat pe Net- 

JCreator jcreator.com Windows Scris în C, este 


JBuilder borland.com/ Windows, Varianta “Per- 
jbuilder/personal | Linux sonal Edition” 
este disponibilă 

gratuit. 


NetBeans IDE | netbeans.org/ide J2SDK 1.3 e) 


VisualAge for | ibm.com/software | Windows Cea mai nouă ver- 
Java /ad/vajava siune este 4.0 


A.2 Instalarea mediului Java 


Pentru a dezvolta şi a rula programe Java, trebuie să instalaţi mediul de pro- 
gramare Java aflat în kit-ul de instalare al Java 2 SDK. Ultima versiune de Java 
disponibilă la momentul scrierii acestei lucrări este 1.4, iar kitul este disponibil 
gratuit la adresa http: //java.sun.com/j2se/1.4/download.html. 
Fiecare sistem de operare are propriul lui kit de instalare, care va fi descărcat 
separat de la adresa anterioară. Sun oferă kit-uri de instalare pentru următoarele 
platforme: 


e Windows; 
e Linux; 


e Solaris. 


După ce descărcaţi kitul de instalare specific sistemului dumneavoastră de o- 
perare, puteţi începe instalarea mediului Java, ajutându-vă la nevoie de ur- 
mătoarele două secţiuni ce descriu instalarea Java 2 SDK v1.4.0 (cea mai re- 
centă versiune testată) pe două sisteme de operare frecvent folosite: Windows 
şi Linux. 
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A.2.1 Instalarea sub Windows 


Java 2 SDK pentru Windows poate fi utilizat sub versiunile Windows 95, 
Window 98 (prima şi a doua ediţie), Windows NT 4.0 cu ServicePack 5, Win- 
dows ME, Windows XP Home, Windows XP Professional, Windows 2000 Pro- 
fessional sau Windows 2000 Advanced Server, pe tehnologie Intel. Pentru a 
putea rula cu succes Java este necesară o configuraţie minimală constând în 
procesor Pentium cu frecvenţa de 166MHz, 32 MB! RAM şi 70MB spaţiu liber 
pe hard-disk . 


A.2.1.1 Instrucţiuni de instalare 


În această secţiune, vom arăta cum se rulează programul de instalare pentru 
a dezarhiva şi instala pachetul Java 2 SDK. Este posibil ca după ce Java 2 SDK 
a fost instalat să vi se ceară repornirea sistemului. Instalarea se face în următorii 


paşi: 


1. În cazul în care aţi descărcat kitul de instalare de pe Internet, verificaţi 
dacă fişierul descărcat este complet. Fişierul j2sdk-1_4_0-win.exe 
trebuie să aibe dimensiunea de 37067134 octeți (bytes) pentru ca descăr- 
carea kitului de instalare să fie considerată completă?; 


2. În cazul în care aveţi deja instalată o versiune Beta sau versiunea Release 
Candidate” de Java 2 SDK 1.4, dezinstalaţi-o. Folosiţi pentru aceasta 
funcţia Add/Remove Programs din Windows, accesibilă din Control Panel 
(Start -> Settings -> Control Panel); 


3. Fişierul j2sdk-1_4_0-win .exe reprezintă programul de instalare al 
Java 2 SDK. Rulaţi fişierul şi urmăriţi instrucţiunile simple care vă sunt 
furnizate de program; 


4. Setaţi variabila sistem PATH. Setarea variabilei sistem PATH vă per- 
mite să puteţi rula convenabil executabilele Java 2 SDK (javac.exe, 
java .exe, javadoc.exe etc.) din orice director fără să fie nevoie să 
scrieţi întreaga cale în linia de comandă. Dacă nu setaţi variabila PATH, 
va trebui să specificaţi întreaga cale către executabil de fiecare dată când 
doriţi să-l rulaţi, ca în exemplul de mai jos: 


! megabytes 

? Atenţie totuşi la versiunea kitului. Dacă ați ales o altă versiune a kitului Java 2 SDK (de 
exemplu, 1.3.0 etc.), mai mult ca sigur că dimensiunea fişierului va fi alta. 

Sversiune anterioară versiunii finale 
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c:>\jdk1.4\bin\javac MyClass. java 


Pentru a evita o asemenea sintaxă incomodă, adăugaţi întreaga cale a di- 
rectorului jdk1 .4 bin la variabila sistem PATH. Dacă la instalare aţi 
ales opţiunile implicite, calea absolută în care se află executabilele Java 
este c:\jdk1.4\bin. 

Setarea căii se realizează diferit, în funcţie de versiunea Windows pe care 
o folosiţi: 

- pentru Windows NT, Windows 2000 şi Windows XP: apăsaţi Start, Set- 
tings, Control Panel, dublu click pe System. În cazul Windows NT, se- 
lectaţi fab-ul Environment; la Windows 2000 selectati rab-ul Advanced 
şi Environment Variables. Apoi, căutaţi variabila sistem PATH în User 
Variables sau System Variables. Dacă nu sunteţi sigur unde anume doriţi 
să adăugaţi calea către executabilele Java, adăugaţi-o la finalul variabilei 
PATH din User Variables. Configurarea căii conţine calea absolută a 
directorului în care este instalat Java (de exemplu, c :\jdk1.4\bin). 
Scrierea cu litere mari sau mici nu are vreo influenţă. În final, apăsaţi Ser, 
OK sau Apply. Variabila sistem PATH este o succesiune de directoare 
separate de ";". Sistemul de operare Windows caută executabilele Java 
(javac, java, javadoc, etc.) în directoarele menţionate în cale, par- 
curgând variabila PATH de la stânga la dreapta. Este important de reţinut 
că în PATH trebuie să aveţi un singur director bin pentru Java SDK la un 
moment dat (celelalte directoare de acest fel care urmează după primul, 
sunt ignorate). Noua cale are efect în fiecare nouă fereastră Command 
Prompt pe care o deschideţi sau în fiecare program pe care îl executaţi de 
acum înainte (cum ar fi JEdit, JCreator etc.). 

- pentru Windows 98, Windows 95: editaţi fişierul autoexec.bat (fo- 
losind de exemplu Start -> Run sysedit). Căutaţi secvenţa în care 
este definită variabila PATH şi adăugaţi în final calea absolută către ex- 
ecutabilele Java. Dacă nu există nici o secvenţă de definire a variabilei 
PATH, adăugaţi-o pe o poziţie oarecare în fişier. Iată un exemplu tipic 
pentru setarea variabilei PATH: 


PATH C: WINDOWS; C: (WINDOWS COMMAND; c:jdk1.4Nbin 
Scrierea cu literele mari sau mici nu are nici o influenţă. Pentru ca setarea 
căii să devină funcţională, executaţi următoarea instrucţiune într-o fereas- 


tră Command Prompt 


c:\> c: lautoexec.bat 
269 


A.2. INSTALAREA MEDIULUI JAVA 


Pentru a afla setarea curentă a căii sau pentru a vedea dacă a avut efect 
schimbarea, tastaţi în linia de comandă: 


c:\> path 


În acest moment, sistemul dumneavoastră este pregătit pentru utilizarea Java 
2 SDK. Pentru a verifica acest lucru, executaţi într-un Command Prompt co- 
manda: 


c:\>java -version 


Dacă instalarea a decurs fără probleme, va fi afişat un scurt mesaj cu date 
despre versiunea Java instalată. Dacă primiți un răspuns similar cu: 


The name specified is not recognized as an internal 
or external command, operable program or batch file. 


înseamnă că mediul Java nu a fost corect instalat sau variabila PATH nu are o 
valoare corectă. 

Pentru dezinstalarea Java 2 SDK, folosiți funcția Add/Remove Programs din 
Control Panel. 


A.2.2 Instalarea sub Linux 


Java 2 SDK rulează de platformele Intel Pentium sau compatibile cu ker- 
nel Linux v2.2.12 şi glibc v2.1.2-11 sau versiuni mai recente. Aveţi 
nevoie de minim 32 MB RAM de memorie şi un spaţiu liber pe hard-disk de 
75MB. Puteți verifica versiunea curentă de glibc folosind comanda: 


ls /lib/libc-* 


A.2.2.1 Instrucţiuni de instalare 


Pachetul Java 2 SDK, Standard Edition, v1.4.0 este disponibil în două for- 
mate de instalare: 


e Un fişierbinar j2sdk-1_4_0-linux-1386.bincare se autoextrage 
(autodezarhivează) şi astfel Java 2 SDK se poate instala în orice locaţie 
de pe disc. Pentru această metodă, consultaţi secţiunea A.2.2.2; 


e fişierul j2sdk-1_4_0-linux-1386-rpm.bincare conţine pachete 
tip RPM(Red Hat Package Manager) cu Java 2 SDK. Pentru a instala 
folosind această metodă, consultaţi secţiunea A.2.2.3. 
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Fişierele pentru ambele formate de instalare sunt cuprinse în cadrul unui fişier 
shell script .bin care afişează licenţa înainte de a începe instalarea. 


A.2.2.2 Instalare cu autoextragere 


Pentru instalare, executaţi paşii următori: 


1. Verificaţi dimensiunea fişierului j2săk-1_4_0-linux-i386.bin. 
O dimensiune de 40618207 bytes indică o descărcare corectă a kitului 
de instalare. Dacă mărimea fişierului nu corespunde celei de mai sus, 
înseamnă că fişierul a fost deteriorat în timpul descărcării. Singura alter- 
nativă este de a încerca din nou descărcarea fişierului; 


2. Copiaţi j2sdk-1_4_0-linux-i386 .bin în directorul în care doriţi 
să instalaţi Java 2 SDK; 


3. Rulaui j2sadk-1_4_0-linux-i386.bin folosind comenzile: 


chmod a+x j2sdk-1_4_0-linux-i386.bin 
./j2sdk-1_4_0-linux-i386.bin 


Scriptul de instalare va afişa o licență de utilizare, după care, dacă accep- 
taţi condițiile expuse în licență, Java 2 SDK se instalează în directorul 
curent; 


4. Adăugați calea absolută către directorul bin rezultat în urma instalării 
(de exemplu, /usr/local/jdk1.4/bin)variabilei sistem PATH. A- 
cest lucru se poate face astfel, funcție de shell-ul pe care îl utilizați: 

- pentru csh sau tcsh: 


% set PATH=(Ș$PATH/usr/local/jdk1.4/bin) 
- pentru sh: 
% PATH=(Ș$PATH/usr/local/jdk1.4/bin); export ȘPATH 


Puteți să adăugaţi liniile anterioare la sfârşitul fişierelor .profile sau 
.cshrc pentru a nu le mai scrie la fiecare login-are. 


Pentru a verifica dacă instalarea a decurs fără probleme, deschideţi o consolă şi 
tastaţi comanda: 


java -version 
271 


A.2. INSTALAREA MEDIULUI JAVA 


Dacă nu au fost semnalate erori pe parcursul procesului, atunci veţi vedea 
un mesaj cu detalii despre versiunea Java instalată. Dacă primiţi răspunsul: 


java: Command not found 


sau ceva similar, atunci mediul Java nu a fost bine instalat sau variabila PATH 
nu are o valoare corectă. 


A,2.2.3 Instalarea folosind RPM 


l. 


4 
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Verificaţi fişierul j2sdk-1_4_0-linux-i386-rpm.bin. O dimen- 
siune de 39482030 bytes indică o descărcare corectă a kitului de instalare. 
Dacă mărimea fişierului nu corespunde celei de mai sus, înseamnă că 
fişierul a fost deteriorat în timpul descărcării. Încercaţi din nou să descăr- 
caţi fişierul respectiv; 


Rulaţi j2sak-1_4_0-linux-i386-rpm.bin folosind comenzile: 


chmod a+x ]J2sdk-1_4_0-linux-1386-rpm.bin 
./j2sdk-1_4_0-linux-i386-rpm.bin 


Scriptul va afişa o licenţă de utilizare, după care, dacă acceptaţi cerinţele 
licenţei, veţi obţine ca rezultat j2sdk-1_4_0-linux-i386.rpm, 
fişier ce va fi creat în directorul curent; 


. Accesaţi sistemul ca root folosind comanda su şi parola acestui cont: 


su - root 


. Dezinstalaţi J2SDK 1.4.0 Beta (în cazul în care există această versiune 


anterioară deja instalată pe calculatorul dumneavoastră) 

Notă: Calea implicită pentru instalarea RPM a lui J2SDK este urmă- 
toarea: /usr/java/]j2sdk1.4.0. Acesta este directorul în care au 
fost instalate şi pre-releaset-urile versiunii 1.4 (în cazul în care acestea au 
fost instalate). Pentru a pregăti instalarea versiunii finale, în acest director 
dezinstalaţi orice versiune pre-release 1.4 care ar putea exista pe sistem. 
Dacă nu sunteţi sigur că aveţi o versiune pre-release 1.4, verificaţi acest 
lucru folosind comanda: 


rpm -query -a | grep ]2sdk-1.4.0 


versiune anterioară versiunii finale 
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Comanda va afişa versiunea instalată, cu numele pachetului RPM al aces- 
teia. După ce aţi aflat numele pachetului îl puteţi dezinstala cu una din 
următoarele comenzi (în funcţie de versiunea beta instalată în momentul 
curent): 

- Pentru a dezinstala versiunea Beta: 


rpm -e ]j2sdk-1.4.0-beta 

- Pentru a dezinstala pachetul Beta 2: 
rpm -e ]j2sdk-1.4.0-beta2 
- Pentru a dezinstala pachetul Beta 3: 
rpm -e ]2sdk-1.4.0-beta3 


5. Rulaţi comanda rpm pentru a instala pachetul Java 2 SDK v1.4.0: 


rpm -iv j2sdk-1_4_0-linux-i386.rpm 


Această comandă va instala Java 2 SDK pe calculatorul dumneavoastră; 


6. Adăugați directorul bin rezultat în urma instalării la variabila sistem 
PATH (vezi pasul 4 de la instalarea cu autoextragere); 


7. Iesiți din contul root. 


Puteți verifica dacă instalarea a fost încununată de succes în acelaşi mod ca şi 
la instalarea cu autoextragere. 


A.3 Compilarea codului sursă 


Odată ce mediul de programare Java a fost instalat şi prima aplicație Java 
a fost creată cu ajutorul unui editor sau mediu IDE, ne punem problema com- 
pilării acestui prim program. 

Pentru a compila o aplicație Java nu este suficient un simplu compilator. 
Pentru ca o aplicație să poată fi compilată, compilatorul are nevoie de bibliote- 
cile Java standard şi eventualele biblioteci folosite de aplicație. 

Compilatoarele sunt în general disponibile împreună cu o maşină virtuală 
Java, care dispune de bibliotecile Java standard şi alte utilitare. Toate aceastea 
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împreună formează un SDK (Standard Development Kit). Tabelul de mai jos 
prezintă câteva SDK-uri mai uzuale, cel mai des folosite fiind cele oferite de 
Sun şi IBM. 


URI 
Blackdown v1.3 blackdown.org 


IBM Developer Kit for | ibm.com/developerworks/ | Windows 
Windows, v1.3.0 java/jdk 


IBM Develorper Kit for | ibm.com/developerworks/ 


Linux, Java 2 Technology | java/jdk 
Edition, v1.3 


Sun Java 2 Platform, Stan- java.sun.com/j2se/1.4 Windows, 
dard Edition, v1.4 Linux, Solaris 


Compilatoarele incluse într-un SDK se apelează cu comanda javac (sau 
comanda jikes în cazul compilatorului realizat de IBM). 

Pentru a compila un program Java (să presupunem că am creat un pro- 
gram numit PrimulProgram. java), trebuie să executăm într-un Command 
Prompt (consolă), în directorul în care este salvat fişierul . java, comanda ur- 
mătoare: 


javac PrimulProgram. java 


Dacă în urma executării acestei comenzi nu s-a afişat nici o eroare şi a fost 
creat un fişier PrimulProgram.class, atunci programul nu are greşeli de 
sintaxă şi putem să îl executăm. 

Pentru ca bibliotecile necesare compilării unei aplicaţii să fie găsite de către 
compilator, acestea trebuie specificate în variabila sistem CLASSPATH. CLASS- 
PATH (asemănător cu variabila sistem PATH) reprezintă o listă de directoare, 
arhive ZIP şi fişiere in format JAR ("jar"-urile sunt de fapt arhive standard ZIP). 
Obiectele listei sunt despărțite prin caracterul °; pe Windows şi prin caracterul 
':* pe Linux. De exemplu, pe Windows 98 variabila CLASSPATH se poate seta 
din autoexec. bat introducând comanda (evident, numele de directoare sunt 
prezentate orientativ): 


set CLASSPATH=d: Lapi interfata. jar;d: Lapi uploadi;. 
iar pe Linux aceasta se poate seta din /etc/profile cu comanda: 


export CLASSPATH=/usr/local/jars/xerces.jar: 
/root/work/server_upload/:. 
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Setarea CLASSPATH se realizează într-un mod analog cu cel al variabilei 
PATH (vezi secţiunea A.2.1.1). 

Compilatorul Jikes, realizat de IBM, este disponibil gratuit la următoarea 
adresă: www. alphaworks.ibm.com/formula/Jikes/. Acesta nu in- 
clude bibliotecile standard şi se foloseşte de obicei împreună cu SDK-ul de la 
Sun, înlocuind compilatorul standard javac, căruia îi este superior ca viteză de 
compilare şi descriere a erorilor. Pentru a putea rula cu succes jikes trebuie 
ca bibliotecile standard oferite de mediul Java (aflate în jre/lib/rt.jar) 
să fie incluse în variabila sistem CLASSPATH. 


A.3.1 Ant 


Ant este o aplicaţie gen “make” (familiară utilizatorilor de Linux) care per- 
mite automatizarea diferitelor operaţii, cum ar fi compilarea unei aplicaţii şi 
pregătirea ei pentru a fi distribuită sau livrată. Ant este foarte util în cazul 
aplicaţiilor Java complexe, care necesită multe operaţii pentru a fi transformate 
din cod sursă în cod binar gata de a fi rulat. De exemplu, pentru a distribui o 
aplicaţie Java pentru telefoane mobile sau PDA-uri sunt necesare următoarele 
operaţii: 


e compilarea fişierelor sursă; 
e preverificarea fişierelor compilate; 


e crearea unei arhive jar care să conţină fişierele sursă compilate, eventuale 
resurse (imagini, sunete etc.) şi alte biblioteci; 


e obfuscarea” arhivei rezultate: 
e crearea unui descriptor al aplicaţiei (fişier JAD); 


e conversia arhivei într-un format acceptat de telefonul mobil sau PDA-ul 
pe care se va rula. 


Cititorii care nu sunt familiarizați cu dezvoltarea de aplicaţii pe unităţi mobile 
nu au înţeles probabil mare lucru din paşii de mai sus. Am vrut doar să punem 
în evidenţă faptul că de la scrierea codului pentru o aplicaţie până la execuţia 
codului pe platforma destinaţie poate fi cale lungă, iar realizarea manuală a 
operaţiilor necesare poate fi extrem de anevoioasă. Există multe soluţii care 


SObfuscarea este un proces prin care se reduce dimensiunea byte-codului, folosind diverse opti- 
mizări (de exemplu, eliminarea metodelor şi atributelor care nu sunt folosite, înlocuirea getter-ilor 
şi setter-ilor cu atributele asupra cărora acţionează etc.). 
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automatizează acest proces, iar unul care se distinge prin eleganţă şi aria extrem 
de largă de aplicabilitate este Ant. Practic, pentru exemplul anterior, compilarea 
şi pregătirea aplicaţiei spre distribuţie devine o simplă rulare a comenzii ant. 

La execuţia comenzii ant, se caută mai întâi în directorul curent fişierul cu 
numele build.xml. Acest fişier trebuie creat manual; el conţine mai multe 
scopuri (engl. targets) care asigură îndeplinirea anumitor sarcini. Lansând ant 
fără nici un parametru se execută scopul implicit, care de obicei este cel care 
asigură compilarea fişierelor sursă ale aplicaţiei. Pentru a executa alt scop, de 
exemplu scopul cu numele “build”, se execută comanda 


ant build 


Iată un exemplu de fişier build.xml: 


<project name="MyComplexApp" default="compile” 
basedir="."> 


<target name="compile"> 
<copy todir="bin"> 
<fileset dir="." includes="*.properties"/> 
</Ccopy> 
<Javac srcdir="src" destdir="bin" debug="on" 
optimize="ọon"/> 
</target> 


<target name="build" depends="compile"> 
<jar jarfile="MyComplexApp.jar" basedir="bin"> 
</target> 


</project> 


În acest exemplu, scopul compile copiază fişierele .properties (de 
exemplu jndi.properties) în directorul bin şi apoi compilează toate 
clasele din directorul src în directorul bin, păstrând structura de directoare. 
Scopul bui ld depinde de scopul compile, deci când se lansează ant build, 
mai întâi se execută scopul compile şi dacă nu apare nici o eroare se execută 
scopul build. Scopul build arhivează fişierele din directorul bin într-o 
arhivă de tip jar numită MyComplexApp. jar. 

Prezentarea Ant din cadrul acestui paragraf este mai mult decât sumară, 
rolul ei fiind doar de a vă deschide apetitul pentru procesarea automată. Mai 
multe detalii puteți afla la adresa http://jakarta.apache.org/ant. 


276 


A.4. RULAREA UNEI APLICAŢII JAVA 


A.4  Rularea unei aplicaţii java 


Execuţia unei aplicaţii Java implică existenţa (pe lângă bibliotecile folosite 
de aplicaţie) unei maşini virutale Java şi a bibliotecilor standard (care conţin 
clasele java.lang.*, java.util.*, java.1io.* etc.). Acestea sunt 
incluse în SDK-uni şi JRE-uri (Java Runtime Environment). Pentru a rula o 
aplicaţie Java este suficient un JRE (mediu de execuţie Java) care, spre deosebire 
de SDK, nu conţine utilitarele pentru dezvoltarea programelor (de exemplu, 
javac), ci doar pe cele necesare execuţiei lor. 

Este necesar să clarificăm nişte denumiri. Până la apariţia versiunii 1.2 a 
JDK-ului (Java Development Kit), denumirea Java 2 Platform Standard Edition 
(J2SE) nu a existat. Începând cu acea versiune, a apărut Java 2 Platform Stan- 
dard Edition cu SDK 1.2 (Standard Development Kit). În continuare au apărut 
SDK 1.3 şi SDK 1.4 care ţin tot de Java 2 Platform Standard Edition. 

Revenind, pentru a rula de exemplu PrimulProgram.class se foloseşte 
comanda următoare, executată în directorul curent: 


java PrimulProgram 


A.4.1 CLASSPATH 


Bibliotecile necesare rulării unei aplicații (cu excepția bibliotecilor stan- 
dard) trebuie incluse în variabila sistem CLASSPATH (aşa cum am descris în 
paragraful A.2) sau pot fi specificate în linia de comandă, folosind optiunea 
-Classpath <CLASSPATH>. 

Utilitarele din SDK folosesc următoarea ordine pentru a căuta o clasă: 


e clasele din <JAVA_HOME>/jre/lib/rt.jar,urmate apoi de clasele 
din arhiva <JAVA_HOME>/jre/lib/i1l8n.jar; 


e clasele din <JAVA_HOME>/jre/lib/ext/*.jar; 


e clasele din variabila CLASSPATH. 


De exemplu dacă este căutată clasa MyClass din pachetul com.mypackage 
şi variabila CLASSPATH are valoarea 
/root/work/server_upload/:/usr/local/jars/xerces. jar, 
atunci fişierul MyClass.class va fi căutat astfel: 


1. în arhivele din jre/lib; 


2. în directorul /root/work/server_upload/com/mypackage/; 
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3. în arhiva /usr/local/jars/xerces. jar,subdirectorul com/my- 
package/. 


A.5  Documentaţii java 


Principala sursă de documentare pentru limbajul Java este site-ul oficial al 
companiei Sun Microsystems: java. sun. com. 

Documentaţia Java 2 Platform Standard Edition se găseşte la adresa de In- 
ternet: http://java.sun.com/j2se/1.4/docs. Acolo poate fi găsită 
şi funcţionalitatea bibliotecilor standard (API). 

Pentru a genera documentaţii în format HTML din fişiere sursă Java, se 
foloseşte utilitarul javadoc. 
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B. Convenții de notație în Java. Uti- 
litarul javadoc 


În Mănăstire existau anumite 
reguli, dar Maestrul ne-a atras 
întotdeauna atenţia asupra tiraniei 
regulilor. 


Anthony de Mello, O clipă de 
înţelepciune. 
Începutul înţelepciunii constă în a 
desemna obiectele cu numele lor 
adecvate. 


Proverb chinzesesc 
Femeile şi pisicile vor face 
întotdeauna ceea ce vor, iar 
bărbaţii şi câinii trebuie să se 
relaxeze şi să se împace cu ideea. 


Robert A. Heinlein 


B.1 Necesitatea convențiilor de scriere a programelor 


Convenţiile de scriere sunt foarte importante pentru programatori din mai 
multe motive: 


e Conform studiilor de specialitate, 80% din costul unei aplicaţii software 
este datorat întreţinerii aplicaţiei respective; 
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e Este foarte puţin probabil ca aplicaţia să fie întreţinută pe întreg parcursul 
existenţei ei doar de către cei care au dezvoltat-o; 


e Convenţiile de notație îmbunătăţesc lizibilitatea codului, permiţând pro- 
gramatorilor să înţeleagă codul nou mai rapid şi mai profund; 


e Dacă aplicaţia scrisă de dumneavoastră este distribuită ca produs, trebuie 
să vă asiguraţi că este bine realizată şi organizată. 


Există deci motive foarte întemeiate pentru a utiliza convențiile de scriere a pro- 
gramelor. Probabil că cititorii vor observa faptul că uneori aceste convenţii nu 
au fost respectate pe parcursul lucrării. Situaţia este explicabilă prin faptul că 
spaţiul disponibil a fost limitat, ceea ce a condus la evitarea utilizării convenţi- 
ilor mai "costisitoare" din punct de vedere al spaţiului tipografic (de exemplu, 
abundența de comentarii javadoc). Totuşi, sugestia noastră este să nu evitaţi 
folosirea acestor convenţii în programele dumneavoastră, indiferent de mărimea 
şi complexitatea aplicaţiilor. 


B.2 Tipuri de fişiere 


Java foloseşte următoarele extensii pentru fişiere: 
e .java, pentru fişiere sursă; 
e .class, pentru fişiere compilate (bytecode). 


Dacă există mai multe fişiere într-un director, atunci este benefică prezenţa unui 
fişier README, care să descrie conţinutul directorului. 


B.3 Organizarea fişierelor sursă . java 


Un fişier sursă este împărţit pe secţiuni, separate prin linii goale şi, opţional, 
un comentariu ce identifică fiecare secţiune. Fişierele cu peste 2.000 de linii 
sunt incomod de parcurs şi modificat şi trebuie pe cât posibil evitate. Vom 
prezenta un exemplu elocvent de program Java formatat în mod corespunzător 
în paragraful B.10. 

Fiecare fişier sursă Java conţine o singură clasă publică sau interfaţă. Când 
clasa publică este asociată cu alte clase sau interfeţe ne-publice acestea se pot 
scrie în acelaşi fişier sursă cu clasa publică, dar clasa publică trebuie să fie prima 
în cadrul fişierului. 

Secţiunile unui fişier sursă Java sunt: 
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e comentariile de început; 
e instrucţiunile package şi import; 


e declaraţiile clasei şi/sau interfeţei. 


B.3.1 Comentariile de început 


Conţin informaţii legate de copyright şi o descriere a fişierului. 
Informaţia copyright are următorul format standard: 


COPYRIGHT NOTICE 

This file contains proprietary information of ... 
Copying or reproduction without prior written 
approval is prohibited. 

Copyright (c) xxxxx 


y Do a A ù N = 
XX x x x 


*/ 


Descrierea fişierului conține observaţii legate de numele fişierului, funcțio- 
nalitatea lui, modul de utilizare a claselor sau interfețelor care îl compun şi alte 
informații adiționale. Comentariul trebuie să fie în stil javadoc (informații 
detaliate despre utilitarul javadoc în paragraful B.11): 


N 


% 

x File name: Salut.java 

x Description : program ce afiseaza un salut de bun venit 
* in lumea Java. Contine clasele: 

x Usage : standard (java Salut) 

* Version: 1.0 

x Date: 15 ianuarie 2002 

*/ 


o y DN ùa àA ù N = 


B.3.2 Instrucţiunile package şi import 


Numele pachetului trebuie să apară pe prima linie necomentată din fişierul 
sursă şi trebuie să respecte convenția de notare stabilită în această anexă. I- 
mediat după aceasta, trebuie să apară declarațiile de import ale claselor. De 
exemplu: 


ı package test.capitolul4; 
2 

3 import java.awt. Graphics; 
4import java.util.*; 
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B.3.3 Declaraţiile clasei şi interfeţei 


O clasă/interfaţă trebuie să fie declarată astfel (exact în această ordine): 


l. 


comentariul de tip javadoc (/** */),în care se precizează informaţii 
publice despre clasă/interfață; 


. cuvântul cheie class sau interface, urmat de numele clasei; 


. opţional, comentariu legat de implementarea clasei/interfeţei (/* */). 


Conţine informaţii private, nenecesare pentru utilitarul javadoc; 


. atributele static. Mai întâi cele public, apoi cele protected, cele 


fără modificatori de acces şi, în final, cele private. Evident, în catego- 
ria atributelor statice intră şi constantele; 


atributele nestatice, în aceeaşi precedenţă ca şi cele statice; 
constructorii clasei; 


metodele clasei. Metodele trebuie grupate din punct de vedere al func- 
ționalităţii, şi nu din punct de vedere al accesibilităţii. De exemplu, o 
metodă statică privată s-ar putea afla între două metode nestatice publice. 
Scopul este de a face codul cât mai uşor de citit şi înţeles. Fiecare metodă 


este precedată de o descriere precisă în format javadoc. 


Documentarea este obligatorie pentru metodele publice. Metodele standard 
de acces la atribute (metodele de tipul get /set) pot fi grupate fără a avea 
o descriere, funcţionalitatea lor fiind binecunoscută (modifică sau returnează 
valoarea unui atribut al clasei). Standardul stabilit pentru descrierea metodelor 
este realizat în aşa fel încât descrierea să fie uşor de înţeles. Multe elemente sunt 
opţionale şi pot fi omise. Fiecare element de pe linie începe cu simbolul asterisk 
(*) şi se termină cu spaţiu. Dacă un element este prezentat pe mai multe linii, 
atunci fiecare linie începând cu a doua trebuie indentată, astfel încât fiecare linie 
să fie aliniată vertical cu cea precedentă. 
Un exemplu arată astfel: 


N 


o IA PN ù PD U N = 
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<descriere detaliata a metodei> 


@ param <descrierea fiecarui parametru al metodei> 
@return <explicarea tipului de valoare returnat> 
@exception <explicarea fiecarei exceptii aruncate> 
@author <numele autorului> 


B.4. INDENTAREA 


Cuvintele aparam, return, Qexception, author reprezintă etichete 
speciale recunoscute de javadoc (paragraful B.11). 
Descrierea detaliată a metodei trebuie să cuprindă: 


e rolul metodei; 
e pre şi post-condiţii; 


e efecte secundare; 


dependențe de alte metode/clase; 
e ce altă metodă ar trebui să apeleze această metodă; 
e dacă metoda trebuie sau nu să fie redefinită în clasele derivate. 


Secţiunea Qpar am descrie tipul, clasa, constrângerile tuturor argumentelor me- 
todei. De exemplu: 


* Qparam strSursa - stringul de intrare. 
Nu poate fi de dimensiune 0. 


Secţiunea Qreturn descrie valoarea returnată de metodă: tipul de date 
returnat, domeniul de valori în care se poate afla valoarea returnată şi, dacă este 
posibil, informaţia de eroare returnată de metodă. De exemplu: 


* return returneaza un intreg din multimea 1..n. 


Secţiunea excepțiilor oferă o descriere a excepțiilor pe care metoda le aruncă. 
De exemplu, 


* Qexception ResourceNotFfoundException - daca resursa 
nu a fost gasita. 


Deşi este evident, adăugăm un exemplu şi pentru secţiunea autor: 


* Qauthor Mihai Ionescu 


B.4  Indentarea 


Codul sursă trebuie să fie indentat, folosind tab-uri şi nu spaţii. Indentarea 
cu tab-uri are avantajul că în aproape toate editoarele de texte se poate modi- 
fica nivelul de indentare selectând dimensiunea preferată pentru caracterul tab. 
Aceasta este în general setată la două (2) spaţii, dar se consideră acceptabil şi 
un fab de patru (4) spaţii. 
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B.4.1 Lungimea unei linii de cod 


Trebuie evitate liniile de cod mai lungi de 80 de caractere, pentru că nu 
pot fi tratate corect de anumite terminale şi editoare. De asemenea, liniile care 
alcătuiesc comentariul javadoc nu trebuie să depăşească 70 de caractere. 


B.4.2 "Ruperea" liniilor 


În situaţia în care o anumită expresie nu este total vizibilă pe ecran (are o 
lungime prea mare), este indicată "ruperea" ei, pentru ca tot codul sursă să fie 
vizibil, fără să fie nevoie de scroll-area orizontală a fişierului. Regulile după 
care se realizează această operaţie sunt următoarele: 


e "rupere" după o virgulă; 


A 


e "rupere" înaintea unui operator; 


e alinierea liniei noi cu începutul expresiei la acelaşi nivel cu linia prece- 
dentă; 


e dacă liniile de cod sunt confuze, indentaţi liniile noi cu 1-2 tab-uri. 


De exemplu: 


1 numeLungl = numeLung2 * (numelLung3 + numeLung4 — numeLung$) 
2 + 4 x numeLung6; //ASA DA 

3 

+ numeLungl = numeLung?2 * (numeLung3 + numeLung4 — 

5 numeLung5) + 4 + numeLung6; //ASA NU 


B.4.3  Acoladele 


Acolada de deschidere trebuie să fie pe linia următoare, aliniată vertical cu 
linia precendentă. Acolada de închidere trebuie să fie pe o linie separată, aliniată 
vertical cu acolada de deschidere. 

Exemplu: 


1 if (conditie) 


2 { 


3 


4) 


Este acceptată şi deschiderea acoladei pe aceeaşi linie cu ultima instrucți- 
une, şi închiderea aliniată vertical cu instrucţiunea care a deschis acolada: 
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1 if (conditie) 
2 s-a 


3) 


Alegerea uneia dintre cele două variante este o chestiune de preferinţă per- 
sonală. Prima are avantajul de a creşte lizibilitatea, dar unii se plâng că ocupă 
prea mult spaţiu. După cum aţi observat studiind codul din această lucrare, 
autorii preferă să utilizeze prima variantă. 


B.4.4  Spaţierea 


Liniile goale plasate adecvat pot îmbunătăţi lizibilitatea codului, împărțind 
codul în secţiuni logice. 


Două linii vide trebuie folosite în următoarele circumstanţe: 


e între secţiunile unui fişier sursă; 


e între definirile claselor şi interfeţelor. 
O linie vidă trebuie folosită în următoarele situaţii: 


e între metode; 
e între variabilele locale ale unei metode şi prima sa instrucţiune; 


e înaintea unui comentariu de tip bloc sau a unui comentariu pe o singură 
linie (vezi secţiunea 5.1 din prezenta anexă). 


Spațiile trebuie folosite în următoarele situaţii: 


e uncuvântcheie urmat de o paranteză trebuie separat prin spaţiu de aceasta. 
Exemplu: 


1 while (true) 


2 | 


3 


4) 


Trebuie reţinut faptul că spaţiul nu este interpretat ca separator de către 
compilatorul Java atunci când se află între numele unei metode şi paran- 
teza care deschide lista de argumente a metodei; 


e un spaţiu trebuie să apară după virgulă (, ) în lista de argumente; 
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e toţi operatorii binari, cu excepţia punctului (.) trebuie separați de ope- 
ranzi prin spaţiu. Spațiile nu se folosesc niciodată pentru a separa opera- 
torii unari şi cei de incrementare/decrementare (++ /-—-—). De exemplu: 


ia =(b+c)/(d+e); 
2b++; 
3 printSize(a, b, c); 


e expresiile dintr-o instrucțiune for trebuie separate prin spațiu. De exem- 
plu: 


for (exprl ; expr2; expr3) 


e operatorul de cast trebuie tot timpul urmat de spațiu: 


myMethod (( byte) unNumar, (Object) x); 


B.5 Comentariile 


Programele Java pot avea două tipuri de comentarii: comentarii de imple- 
mentare şi comentarii pentru documentație. Comentariile de implementare sunt 
de tipul celor din C++, delimitate prin /*...*/ sau //. Comentariile pentru 
documentație, cunoscute sub numele de comentarii javadoc, sunt disponibile 
doar în Java şi sunt delimitate de /**...*/. Comentariile javadoc pot fi 
extrase şi formatate în fişiere HTML folosind aplicația utilitară javadoc. 

Comentariile de implementare aduc clarificări asupra codului sursă şi sunt 
adresate programatorilor care lucrează sau vor lucra la scrierea codului. Co- 
mentariile de documentaţie aduc clarificări asupra rolului fiecărei clase, inter- 
feţe, metode etc. şi sunt adresate celor care doresc să utilizeze clasele scrise de 
noi, fără a fi interesaţi de detaliile de implementare (codul sursă). 

Comentariile conţin doar informaţii relevante pentru citirea şi înţelegerea 
programului. În general, este bine să se evite duplicarea informaţiei care este 
prezentată într-o formă clară în interiorul codului. De asemenea, este bine să 
se evite comentarii care ar putea deveni neactuale pe măsură ce codul sursă 
evoluează. Pe de altă parte, comentariile nu trebuie să fie folosite în mod abuziv. 
Frecvența mare a comentariilor reflectă uneori o calitate slabă a codului. Dacă 
simţiţi nevoia să comentaţi foarte des codul, este cazul să luaţi în considerare 
rescrierea lui pentru a-l face mai clar. 
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B.5.1 Comentarii de implementare 


Programele pot avea patru stiluri de comentarii de implementare: în bloc, 
pe o singură linie, comentarii de tip trailing şi comentarii de tip sfârşit de linie. 


e Comentarii de tipul bloc 


Comentariile de tipul bloc sunt folosite pentru a oferi descrieri ale fişierelor, 
metodelor, structurilor de date şi algoritmilor. Ele pot fi folosite la în- 
ceputul fiecărui fişier şi înainte de fiecare metodă. Dacă sunt folosite în 
interiorul unei metode, comentariile de tipul bloc trebuie să fie indentate 
pe acelaşi nivel cu codul sursă pe care îl descriu. 


Exemplu: 


1 /* 
2 * Acesta este un comentariu de tip bloc 
3 */ 


e Comentarii pe o singură linie 


Comentariile mai scurte pot să apară pe o singură linie, indentată la nivelul 
codului care urmează. Dacă nu poate fi scris pe o singură linie, comen- 
tariul trebuie transformat într-un comentariu de tip bloc. 


Exemplu: 


1 if (conditie) 


2 
3 /x Trateaza cazul cand conditia este adevarata. */ 
4 


5} 


e Comentarii de tipul trailing 


Comentariile foarte scurte pot să apară pe aceeaşi linie cu codul pe care 
îl descriu, dar trebuie să fie indentate mai mult pentru a le separa de cod. 
Toate comentariile de acest tip care apar într-o porţiune de cod trebuie să 
aibe aceeaşi indentare. 


Exemplu: 

1if (a == 2) 

2 { 

3 return truc; /*x caz special, 2 este prim */ 
4) 

s else 

6 { 

7 return isPrime (a); /x verifica daca a este prim*/ 
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e Comentarii de tipul sfârşit de linie 
Delimitatorul / / comentează o linie complet sau parţial. 
Exemplu: 


1 if (myAge > 1) 
2 { 


3 // executa o operatie 
4 


5} 


B.5.2 Comentariile de documentație 


Platforma Java oferă o aplicație utilitară, denumită javadoc, foarte uti- 
lizată în crearea de documentații pentru pachetele şi clasele Java. Practic, această 
aplicație a impus un standard în materie de documentare a programelor. Comen- 
tariile de documentație descriu clasele, interfețele, constructorii, metodele şi 
atributele. Fiecare astfel de comentariu se găseşte între delimitatorii /**...*/, 
cu specificația că există câte un singur comentariu pentru fiecare clasă, interfață 
sau membru al clasei. 

Exemplu de comentariu de documentație: 


1 /** 

2 * Clasa Vehicle ofera 
3 */ 

4 public class Vehicle 


s { 


6 


7} 


Comentariile de documentație nu trebuie poziționate în cadrul vreunei meto- 
de sau constructor, pentru că Java asociază aceste comentarii cu prima declarare 
de metodă pe care o întâlneşte după comentariu. Amănunte despre modul de 
utilizare javadoc sunt prezentate în paragraful B.11. 


B.6 Declarări 


B.6.1 Numărul de declarări pe linie 
Se recomandă folosirea unei singure declarări de variabilă pe o line, deoa- 
rece astfel se încurajează comentarea liniilor respective. De exemplu, varianta 


int i; // indicele sirului 
int dim; // dimensiunea sirului 
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este preferată variantei 


int i, dim; 


B.6.2  Iniţializarea variabilelor 


Este indicat ca iniţializarea variabilelor să se facă în momentul declarării. 
Există situaţii în care acest lucru nu este posibil, de exemplu când valoarea 
iniţială a variabilei depinde de anumite calcule care trebuie mai întâi efectuate. 


B.6.3 Locul de declarare a variabilelor 


Cel mai bine este ca declaraţiile variabilelor să fie realizate la începutul 
blocului în care sunt folosite (un bloc este delimitat de acolade ()), pentru a 
evita posibilele confuzii de notație. 


B.6.4 Declararea claselor şi a interfeţelor 


In cazul declarării de clase sau interfeţe trebuie respectate următoarele reguli 
de formatare: 


e nu există spaţiu între numele metodei şi paranteza " (" cu care începe 
lista de parametri; 
e metodele sunt despărțite printr-o linie vidă 
Exemplu: 
ı class Test 


2 | 
3 void firstMethod () 


{ 


void secondMethod () 


4 
5 
6 ) 
7 
8 
9 
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B.7 Instrucţiuni 


B.7.1 Instrucţiuni simple 


Pentru claritate, fiecare linie trebuie să conţină cel mult o instrucţiune. Ten- 
dinţa generală a programatorilor începători de a scrie mai multe instrucţiuni 
pe o singură linie, pentu ca astfel programele să pară mai “mici” este puerilă 
şi nejustificată. Un program aerisit, în care instrucţiunile se succed una sub 
cealaltă este mult mai uşor de parcurs şi de înţeles decât un program îmbâcsit şi 
înghesuit, chiar dacă acesta este de trei ori mai scurt: 


ı argv ++; //ASA DA 
2 argc——; //ASA DA 
3 


4argv ++; argc——; //ASA NU 


B.7.2 Instrucţiuni compuse 


Instrucţiunile compuse reprezintă o listă de instrucţiuni cuprinse între aco- 
lade 4). 


e instrucţiunile compuse se indentează cu un nivel faţă de instrucţiunea care 
le compune: 


1 if (conditie) 


2 | 


3 instructiune_indentata_cu_un_nivel; 


4) 


e acolada de deschidere trebuie să fie pe o linie nouă aliniată vertical cu 
linia precedentă, iar acolada de închidere trebuie să fie pe o linie nouă, 
aliniată vertical cu acolada de deschidere: 

1 if (conditie) 
2 { //aliniere verticala cu instructiunea 


3 
4) //aliniere verticala cu acolada de deschidere 


e acoladele trebuie folosite pentru toate instrucţiunile, chiar şi pentru o sin- 
gură instrucţiune, atunci când fac parte dintr-o structură de tipul if-else 
sau for. Astfel este mai simplu de adăugat instrucţiuni, fără a genera ac- 
cidental erori datorate uitării introducerii de acolade, iar codul devine mai 
clar. 
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B.7.3 Instrucţiunea return 


Instrucţiunea return utilizată împreună cu o valoare nu trebuie să folo- 
sească parantezele decât dacă acestea fac valoarea returnată mai evidentă într- 
un anumit fel. De exemplu: 


„return; 
2 return age; 
sreturn (dim ? dim : defaultDim); 


B.7.4 Instrucţiunea if-else 


Instrucţiunea if-else trebuie să aibă următoarea formă: 


1if (conditie) 


24 
3 instructiuni; 
4) 
sau: 
1 if (conditie) 
2 { 
3 instructiuni; 
4) 
s else 
6 | 
7 instructiuni; 
8) 
sau: 


1 if (conditie) 


2 { 


3 instructiuni; 


a} 


s else if (conditie) 


sl 


7 instructiuni; 


11 instructiuni; 


Instrucţiunea if foloseşte întotdeauna acoladele. Evitaţi următoarea formă 
generatoare de erori logice: 


1 if (conditie) //EVITATI! SE OMIT ACOLADELE. 
2 
3 instructiune; 
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B.7.5 Instrucţiunea for 


O instrucţiune for are următorul format: 


ı for (initializare ; conditie; actualizare) 


2 { 


3 instructiuni; 


4) 
O instrucţiune for vidă trebuie să fie de următoarea formă: 


for (initializare ; conditie; actualizare) 


ki 


B.7.6 Instrucţiunea while 


O instrucţiune while trebuie să fie de următoarea formă: 


1 While (conditie) 


2 { 


3 instructiuni; 


4) 
O instrucţiune while vidă trebuie să fie de următoarea formă: 


while (conditie) 


3 


B.7.7 Instrucţiunea do-while 


O instrucțiune do-whi le are următoarea formă: 


1 do 
24 


3 instructiuni; 


4) 


s while (conditie); 


B.7.8 Instrucţiunea switch 


Instrucţiunea switch trebuie să arate astfel: 


ı switch (conditie) 


2 { 


3 case ABC: 

4 instructiuni; 

5 /x NU are break */ 
6 
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7 case DEF: 

8 instructiuni; 
9 break ; 

10 

11 case XYZ: 

12 instructiuni; 
13 break ; 

14 

15 default: 

16 instructiuni; 
17 break ; 


De fiecare dată când un case nu are instrucţiune break, precizaţi acest 
lucru printr-un scurt comentariu. Orice instrucţiune switch trebuie să includă 
un caz default. 


B.7.9 Instrucţiunea try-catch 


Formatul unei instrucţiuni try-catch este următorul: 


1 try 
2 { 


3 instructiuni; 


4) 
s catch (ClasaDeTipExceptie e) 


sl 


7 instructiuni; 


8) 


Numărul de instrucţiuni catch poate fi mai mare de 1. O instrucţiune de 
tipul try-catch poate să includă şi finally, care se execută indiferent 
dacă blocul try s-a executat cu succes sau nu: 


3 instructiuni; 


4) 
s catch (ClasaDeTipExceptie e) 


sl 


7 instructiuni; 
8} 

o finally 

10 { 


11 instructiuni; 


12 ) 
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B.8 Convenții de notație 


Convenţiile de notație fac programele mai uşor de înțeles datorită faptului 
că sunt mai uşor de citit. De asemenea, ele dau informații despre metode, de- 
spre identificatori — de exemplu dacă este o constantă, un pachet sau o clasă — 
informaţii care pot fi folositoare în înţelegerea codului. 


e Pachete 
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Pachetele trebuie să aibă nume unice, pentru a evita posibile erori de iden- 
tificare. Numele pachetului este format numai din litere mici ale alfabetu- 
lui. Evitaţi folosirea majusculelor. Trebuie reţinut faptul că aplicaţiile 
utilitare Java fac diferenţa între literele mici şi cele mari ale alfabetului 
(sunt case-sensitive). Prefixul unui nume de pachet trebuie să fie unul 
dintre numele de domeniu com, edu, gov, mil, net, org, sau unul 
dintre codurile formate din două litere care identifică ţara, în conformi- 
tate cu standardul ISO 3166. De exemplu: ro pentru România, de pentru 
Germania, fr pentru Franţa etc. Următoarele componente ale numelui 
unui pachet diferă în funcţie de convențiile fiecărei companii producă- 
toare de software. Aceste convenţii pot specifica departamentul, proiectul 
etc. Numărul lor poate fi oricât de mare, dar este de preferat ca structura 
să nu fie prea stufoasă. 


Exemple de nume de pachete: 


com. sun.eng 
com.ibm.jdk 
ro.firmaMea.proiectul2.util 
ro.firmaMea.proiectul2.login 


Clase 


Numele claselor începe întotdeauna cu majusculă şi este format din unul 
sau mai multe substantive. Dacă sunt mai multe substantive, atunci prima 
literă a fiecărui substantiv este şi ea majusculă. Încercaţi să păstraţi aceste 
denumiri simple. Utilizaţi cuvintele întregi în defavoarea abrevierilor (cu 
excepţia cazului în care abrevierea este mai des utilizată decât numele 
întreg, cum este cazul HTML sau URL) 


Exemplu de nume de clase: 


class Vehicle; 
class SortedVector; 
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Numele claselor derivate poate fi construit, dacă este posibil, prin insera- 
rea unui cuvânt înaintea numelui clasei de bază: din clasa Chart se pot 
deriva clasele AreaChart, LineChart; 


Interfeţe 


Numele interfeţelor respectă condiţiile impuse numelor de clase. Pro- 
gramatorii sunt încurajați să folosească prefixul I pentru a denumi o in- 
terfaţă, dar acest lucru nu este obligatoriu. 


Exemplu de nume de interfeţe: 


interface IBook; 
interface Disk; 


Metode 


Numele metodelor reprezintă acţiuni, deci vor conţine verbe. Numele 
metodelor începe cu literă mică, dar fiecare cuvânt, începând cu al doilea 
în cazul în care există, va începe cu majusculă. 


Exemplu de nume de metode: 


void cancelOrder (); 
void run); 
void mergeSort (); 


Numele metodelor standard de acces la atributele unei clase (metodele de 
tipul get / set) trebuie să conţină prefixul get sau set, după cum este 
cazul. 


Exemplu: 


1 /** 

2 x» Returneaza valoarea atributului name din clasa. 
3 */ 

4 String getName (); 

5 

6 /* * 

7 * Modifica valoarea atributului name, atribuindu—i 
s x noua valoare newName. 

9 */ 

10 void setName( String newName ); 


În cazul atributelor de tip boolean, metodele de tip get trebuie să fo- 
losească prefixele is, can sau has. 


De exemplu, varianta: 


// returneaza valoarea booleana student 
boolean isStudent(); //ASA DA 
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este de preferat variantei: 


boolean getStudent (); //ASA NU 


e Variabile 


Numele variabilelor începe cu literă mică, dar fiecare cuvânt, începând 
cu al doilea în cazul în care există, va începe cu majusculă. Numele de 
variabile nu trebuie să înceapă cu linie de subliniere (_), sau simbolul 
dolar ($), deşi acest lucru este permis de limbajul Java. 


Numele variabilelor trebuie să fie scurte, dar cu înţeles. Numele de vari- 
abile formate dintr-o singură literă trebuie folosite doar pentru variabile 
temporare: i, j, k, m, n sunt folosite pentru variabile de tip întreg, în 
timp ce c, d, e sunt folosite pentru variabile de tip caracter. 


Exemplu de nume de variabile: 


int i; 
char c; 
float carWidth; 


e Constantele 


Numele constantelor este scris în totalitate cu majuscule. Dacă sunt mai 
multe cuvinte în componenţa unui nume de constantă, atunci acestea sunt 
separate prin linie de subliniere (_). 


Exemplu de nume de constante: 


static final int MIN WIDTH 1 
static final int MAX WIDTH = 4; 
static final int GET_THE_CPU = 


B.9 Practici utile în programare 


B.9.1 Referirea atributelor şi a metodelor statice 


Evitaţi folosirea unui obiect pentru a accesa metodele şi atributele statice 
ale unei clase. Este de preferat să folosiți numele clasei, punând astfel clar în 
evidență faptul că este vorba despre un membru static: 

ı staticMethod (); //0K 
2 MyClass . staticMethod (); //OK 
3 


4 MyClass cl = new MyClass (); 
s cl.staticMethod (); //EVITATI 


296 


B.10. EXEMPLU DE FIŞIER SURSĂ JAVA 


B.9.2 Atribuirea de valori variabilelor 


Evitaţi atribuiri multiple pe aceeaşi linie de cod, ca în exemplul: 


Clasal .carl = Clasa? .car?2 = 'c'; //ASA NU 


Nu folosiţi atribuiri imbricate pentru a îmbunătăţi performanţa execuţiei. 
Acest lucru va fi realizat de compilator: 
ıd = (a = b + c) + r; //ASA NU 
2 


3a = b + c; //ASA DA 
ad = a + T; 


Folosiţi parantezele în cadrul expresiilor cu mulți operatori, pentru a evita 
probleme de precedenţă a operatorilor: 
„if (a == b && c == d) //ASA NU 


2 


sif ((a == b) && (c == d)) //ASA DA 


Adăugaţi comentarii speciale anumitor părți de cod despre care ştiţi că sunt 
susceptibile la erori sau nu funcționează deloc. 


B.10 Exemplu de fişier sursă Java 


Fişierul Java listat în continuare este un exemplu de program Java care res- 
pectă convențiile de programare prezentate în această anexă: 


/* 

* COPYRIGHT NOTICE 

This software is the confidential and proprietary 
information of MySoftware Ltd. 


Copyright (c) 2002 MySoftware Ltd. 
Silicon Alley 4B, Brasov, Romania 


1 
2 
3 
4 
5 
6 
7 
8 
9 All rights reserved. 


XXX EX x 


10 */ 
11 
2 package com .myPackage . vehicles; 
13 
4 import java.util. Vector; 
15 
16 /* * 
17 * FileName : Car. java 

x Description : defineste o masina 
19 * 

x @version 1.00 15 Ianuarie 2002 
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2 x» Qauthor Ionescu Mihai 


2 */ 

2 public class Car extends Vehicle 

24 f 

25 /x Comentariu de implementare a clasei. */ 

26 

27 /*xx* Comentariu de documentatie pentru classVari. */ 

28 public static int classVarl; 

29 

30 /* * 

31 x Comentariul de documentatie pentru variabila classVar?2 
32 x este mai lung de o linie. 

33 */ 

34 private static Object classVar2; 

35 

36 /xx Comentariu de documentatie pentru instanceVarl. */ 
37 public Object instanceVarl ; 

38 

39 /xx Comentariu de documetatie pentru instanceVar2. */ 
40 protected int instanceVar?2; 

41 

42 /xx Comentariu de documentatie pentru instanceVar3. */ 
43 private Object [] instanceVar3; 

44 

45 

46 /x* * 

47 x Comentariu de documentatie pentru constructorul clasei 
48 x / 

49 public Car() 

50 { 

51 // ... implementarea constructorului... 

52 } 

53 

54 /** 

55 x Comentariu de documentatie pentru metoda doSomething. 
56 */ 

57 public void doSomething () 

58 { 

59 // ... implementarea metodei. 

60 } 

61 

62 /*x* 

63 x Comentariu de documentatie pentru metoda doSomethingElse. 
64 x Qparam someParam descrierea parametrului 

65 */ 

66 public void doSomethingElse (Object someParam ) 

67 { 

68 // ... implementarea metodei... 

69 } 

70 ) 
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B.11  Utilitarul javadoc 


Javadoc este o aplicație utilitară oferită de Sun Microsystems împreună 
cu JDK pentru a genera documentație API! în format HTML pornind de la co- 
mentariile de documentație din cadrul fişierelor sursă. Javadoc este inclus în 
distribuția J2SDK, sub forma unei aplicații cu acelaşi nume şi se află în direc- 
torul bin al distribuţiei. Utilitarul nu poate fi obţinut separat, ci doar ca parte 
integrantă a J2SDK. 

javadoc este foarte bine documentat de către creatorii săi. Lucrarea de 
faţă va prezenta în cele ce urmează, doar informaţii absolut necesare pentru a 
putea folosi acest utilitar. Mult mai multe informaţii despre javadoc se pot 
găsi fie în cadrul documentaţiei J2SDK, fie la adresa următoare: 
nttp://java.sun.com/j2se/javadoc/index.html. 


B.11.1 Sintaxa javadoc 


Sintaxa generală javadoc arată astfel: 


javadoc [optiuni] |lnume-pachete] [fisiere-sursa] 
[Enume-fisiere] 


Iată descrierea celor patru parametri opţionali ai comenzii: 


e optiuni reprezintă opţiunile utilitarului şi vor fi detaliate pe parcursul 
acestei anexe; 


e nume-pachete reprezintă numele pachetelor pentru care se crează do- 
cumentaţia. Numele sunt separate prin spaţiu, ca în exemplul java.io 
java.util java.lang. Fiecare pachet care va fi documentat tre- 
buie specificat separat. De reţinut faptul că javadoc foloseşte opţiunea 
numită -sourcepath pentru a căuta aceste pachete. Transmiterea ca 
argument a unui nume de pachet implică procesarea de către javadoca 
tuturor fişierelor . java din directorul corespunzător pachetului respec- 
tiv, chiar şi dacă fişierele . java reprezintă exemple de utilizare a anu- 
mitor clase sau, pur şi simplu, sunt clase care nu fac parte din pachetul 


! API = Application Program Interface. Acest termen desemnează metoda specifică prescrisă de 
sistemul de operare al unui calculator sau de o anumită aplicaţie prin care un programator care scrie 
o aplicaţie poate interacţiona cu sistemul de operare sau aplicaţia respectivă. În cazul nostru, docu- 
mentaţia API reprezintă o descriere în format HTML a claselor, interfeţelor, metodelor, atributelor 
etc. din cadrul pachetelor Java, care are rolul de a descrie rolul acestora şi modul în care pot fi 
utilizate de un programator. 
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respectiv. Acest lucru are loc din cauza faptului că javadoc nu parsează 
fişierele . java în căutarea unei declaraţii de pachet (package); 


e fisiere-sursa reprezintă numele fişierelor sursă, separate prin spaţiu, 
fiecare dintre fişiere putând fi precedate de locaţia lor: Button. java, 
awt /Graphics*.java. Calea care precedă numele fişierului sursă 
determină unde va fi căutat acesta de javadoc. Javadoc nu foloseşte 
-sourcepath pentru a căuta fişierele sursă. Exemplul precedent arată 
totodată că este permisă folosirea de wildcard-uri (Graphics* . java). 
Acestea uşurează uneori foarte mult lucrul celui care realizează documen- 
taţia, deoarece mai multe fişiere pot fi precizate printr-o singură comandă 
(de exemplu, Graphics* . java cuprinde denumirile tuturor fişierelor 
a căror denumire începe cu Graphics, este urmată de orice succesiune 
de caractere şi au extensia . java: Graphics.java, Graphics- 
Standard. java, GraphicsTemplate. java etc.). Clasele sau 
interfețele pentru care se generează documentaţia completă prin rularea 
javadoc poartă numele de clase documentate; 


e Cnume-fisiere reprezintă fişiere care conţin numele de pachete sau 
de fişiere care vor fi documentate. Ordinea pachetelor şi a claselor din 
cadrul fişierelui nu are importanţă, dar trebuie să apară câte una pe linie. 
Această opţiune este în special utilă pentru a evita apariţia unor liste foarte 
”stufoase” de parametri reprezentând numele de pachete şi fişierele sursă. 


B.11.2 Descrierea utilitarului 


Javadoc parcurge declaraţiile şi comentariile de documentaţie dintr-un 
set de fişiere Java şi crează un set corespondent de pagini HTML, descriind (im- 
plicit) clasele public şi protected, clasele interioare (engl. inner classes), 
intefeţele, constructorii, metodele şi atributele. Utilitarul poate fi folosit pe pa- 
chete întregi, pe fişiere sursă separate, dar şi în variantă combinată, pe pachete 
şi fişiere. În primul caz, argumentul utilitarului javadoc este o serie de nume 
de pachete, în timp ce în al doilea caz, argumentul este reprezentat de o serie de 
nume de fişiere sursă . java. 

Pentru a putea fi utilizat, javadoc are nevoie de compilatorul Java. Java- 
doc utilizează javac pentru a compila declaraţiile din fişierele sursă, ignorând 
implementarea membrilor claselor respective. În acest fel, javadoc constru- 
ieşte o bogată reprezentare internă a claselor, inclusiv ierarhia de clase şi re- 
laţiile dintre clase, create prin utilizarea lor. Folosind această reprezentare, 
javadoc generează documentaţia HTML. Pe lângă aceste informaţii, javadoc 
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mai foloseşte şi informaţiile oferite de programator în cadrul comentariilor de 
documentaţie din fişierele sursă. 

Când crează structura internă a claselor, javadoc încarcă toate clasele 
referite, cu alte cuvinte clasele sau interfețele care sunt explicit referite în de- 
finirea (implementarea) claselor/interfeţelor documentate. Exemple de referire 
sunt tipul de valoare returnată, tipurile de parametri, tipul către care se realizea- 
ză o operaţie de cast, clasa extinsă, interfaţa implementată, clasele importate, 
clasele folosite în definirea corpurilor metodelor, etc. Pentru a funcţiona corect, 
javadoc trebuie să fie în măsură să găsească toate clasele referite. Faptul că 
javadoc utilizează compilatorul Java, javac, ne asigură de faptul că docu- 
mentaţia HTML obţinută corespunde exact cu implementarea propriu-zisă. 

Conţinutul şi formatul documentaţiei generate de javadoc pot fi modifi- 
cate conform preferințelor folosind o componentă denumită doclet. Utilitarul 
javadoc are în mod implicit o astfel de componentă, denumită docler stan- 
dard, care generează documentaţia API în format HTML. Doclet-ul standard 
poate fi înlocuit cu altul care generează documentaţie în format PDF, XML, MIF, 
RTF sau alte formate. Există diverse doclet-uri create de Sun Microsystems, dar 
şi de alte companii. Sun oferă trei doclet-uri: doclet-ul standard, prezentat an- 
terior, doclet-ul MIF, care generează documentaţia API în format MIF (folosit 
de Adobe FrameMaker), PDF, PS sau RTF, şi docler-ul DocCheck, pentru ve- 
rificarea corectitudinii comentariilor de documentaţie din fişierele sursă. 

Lista doclet-urilor pe care le puteţi folosi include şi următoarele aplicaţii, 
realizate de diverse alte companii: 


e Dynamic Javadoc (sau DJavadoc), ce generează HTML în format dinamic 
(DHTML); 


e RTFDoclet, care generează documente în format RTF, care pot fi vizua- 
lizate cu MS Word; 


e DocLint, care verifică corectitudinea comentariilor de documentaţie?. 


Totuşi, dacă sunteţi de părere că aceste doclet-uri nu vă sunt de folos, puteţi să 
vă implementaţi propriul dumneavoastră doclet. 

Implicit, javadoc utilizează doclet-ul standard şi în majoritatea situaţiilor 
vă veţi mulţumi să îl utilizaţi pe acesta. Schimbarea acestuia cu unul la alegere 
se face prin specificarea opțiunii -doclet la apelul javadoc. 


2Probabil că vă întrebaţi cum poate fi o documentaţie incorectă. După cum vom vedea în con- 
tinuare, comentariile javadoc pot să conţină şi anumite cuvinte cheie (etichete) care impun o 
anumită sintaxă. Corectitudinea comentariilor de documentaţie se referă la utilizarea corespunză- 
toare a acestor cuvinte cheie, şi nicidecum la corectitudinea conţinutului. 
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După cum precizam anterior, javadoc generează documentaţia API pe 
baza fişierelor sursă . java. Opţional, acestora li se mai pot adăuga şi alte 
tipuri de fişiere: 


e fişiere de comentare a pachetului. Fiecare pachet poate avea propriul 


lui comentariu de documentare, în care să fie precizate informaţii vala- 
bile pentru întreg pachetul. Pentru a realiza acest lucru, trebuie creat un 
fişier HTML cu numele packages.html, localizat în acelaşi director 
cu fişierele sursă . java care formează pachetul respectiv. Javadoc 
caută automat în fiecare director un fişier cu acest nume şi îl cuprinde în 
documentaţie; 


fişiere de comentare per ansamblu. Există posibilitatea de a crea un co- 
mentariu la nivel de aplicaţie sau pentru mai multe pachete simultan. 
Crearea unui astfel de comentariu se face prin intermediul unui fişier de- 
numit overview.html. Fişierul poate fi plasat oriunde, pentru că este 
unic în cadrul unei documentaţii generate, dar este de preferat să fie lo- 
calizat în directorul rădăcină al fişierelor sursă . java. Ca şi în cazul 
anterior, acest fişier trebuie scris în HTML; 


fişiere de alte tipuri (imagini, exemple de programe Java etc.), care sunt 
doar copiate de javadoc în directorul destinaţie. Aceste fişiere sunt 
necesare în cazul în care, de exemplu, comentariul de documentaţie din 
fişierul sursă face referire la o imagine etc. 


Implicit, rezultatul generării documentaţiei este o structură de directoare, de- 
oarece javadoc foloseşte doclet-ul standard, care generează HTML. Direc- 
toarele respective conţin fişierele HTML generate propriu-zis de javadoc şi 
eventualele fişiere (imagini, exemple de programe) care au fost doar copiate de 
javadoc. Pentru vizualizarea documentaţiei generate, este de ajuns să aveţi 
un browser de Internet (de exemplu, Internet Explorer sau Netscape Naviga- 
tor) şi să accesaţi pagina index.html din rădăcina directorului în care se 
află documentaţia generată. Accesarea acestei pagini oferă posibilitatea de a 
vedea rezultatul eforturilor de documentare a fişierelor Java. Documentaţia este 
prezentată sub forma a două frame-uri HTML (dacă nu a fost generată pentru 
pachete) sau sub forma a trei frame-uri HTML (în cazul pachetelor): 
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C = lista claselor pentru care s-a realizat documentaţia 
Detaliu = detaliile unei clase selectate în frame-ul din stânga 


P = lista pachetelor pentru care s-a realizat documentaţia 

C = lista claselor din pachetul selectat în frame-ul din stânga sus 

Detaliu = detaliile unei clase selectate în frame-ul din stânga jos 

Dacă pentru generarea documentaţiei nu a fost folosit doclet-ul standard, 
atunci formatul documentaţiei generate este altul, pentru vizualizarea ei fiind 
necesare, în mod firesc, alte aplicaţii. 

Implicit, javadoc transformă comentariile în cod HTML, de aceea comen- 
tariile în sine pot conţine cod HTML, pentru a permite o formatare mai bună. 
Prima propoziţie a comentariului trebuie să reprezinte o descriere succintă dar 
completă a elementului comentat, deoarece această propoziţie este folosită de 
javadoc pentru a crea un rezumat al descrierii clasei, interfeţei, metodei sau 
pachetului respectiv. Se consideră sfârşitul propoziției simbolul punct (.), urmat 
de spaţiu, tab sau apariţia unui etichete speciale suportată de javadoc (detalii 
despre etichetele javadoc în secţiunea 11.3). Aşadar, evitaţi comentariile de 
genul: 

1 /** 


2 x Modifica nota acordata de prof. unui elev. 
3 */ 


Dacă doriți să folosiți totuşi exprimarea anterioară, atunci apelați la urmă- 
torul truc: 


1 /** 
2 x Modifica nota acordata de prof.&nbsp;unui elev. 
3 */ 


B.11.3 Etichete javadoc 


In cadrul comentariilor de documentație din interiorul fişierelor sursă, java- 
doc suportă anumite etichete, care sunt tratate special. Fiecare etichetă începe 


cu semnul €. 
Lista completă a etichetelor javadoc este formată din următoarele ele- 


mente: 
303 


B.11. UTILITARUL JAVADOC 
e dauthor 
e (deprecated 
e Cexception 
e lparam 
e return 
e (see 
e serial 
e CserialData 
e CserialFfield 
e since 
e Cthrows 


e version 


{@docRoot} 
e {@link} 


Unele dintre acestea au fost deja utilizate în cadrul paragrafului B.3.3, la decla- 
rarea claselor şi a interfeţelor, altele vor fi prezentate în continuare. 

edeprecated adaugă în documentul generat un comentariu care arată 
că elementul respectiv (clasă, interfaţă, metodă etc) este învechit şi că nu ar 
mai trebui folosit (chiar dacă ar putea să funcţioneze). Totodată, trebuie pre- 
cizat elementul care ar trebui folosit în locul celui demodat. Mod de utilizare: 
Qdeprecated comentariu. 

see adaugă informaţii ajutătoare, de genul "vezi metoda X". Informaţia 
apare la secţiunea See also a documentaţiei generate, putând fi un simplu text 
sau un link către alte elemente. Poate fi utilizat în următoarele forme: 


e see "comentariu", afişează text simplu 


e (see <a href="URL-ul">Numele link-ului< /a>, afişea- 
ză un link HTML 
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e see pachet.clasatmembru numeLink, afişează un link HTML 
către documentaţia generată pentru membrul care aparţine clasei din pa- 
chetul specificat. 


since afişează un text care indică versiunea aplicaţiei software care a prezen- 
tat pentru prima dată elementul respectiv. De exemplu, âsince 1.3 denotă 
faptul că elementul a apărut în versiunea 1.3 a aplicaţiei. 

version este utilizat în general cu argumentul "%I%, %G%", care este 
convertit de javadoc în ceva similar cu "1.39, 02/28/99" (luna/zi/an), 
adică versiunea şi data trecerii la versiunea respectivă. 

(link pachet.clasatmembru numeLink) se aseamănă cu eti- 
cheta see, cu deosebirea că link-ul creat nu este afişat în secţiunea See also, 
ci chiar în cadrul textului în care este folosit. 


B.11.4 Opțiunile comenzii javadoc 


Opțiunile comenzii javadoc sunt destul de numeroase. Pentru a vedea 
lista completă a tuturor acestor opţiuni, executaţi 

javadoc 
în linia de comandă. Vom prezenta în continuare cele mai uzuale opțiuni: 

-overview caleCatreFisier 

Javadoc foloseşte această opțiune pentru a prelua comentariul de ansam- 
blul al aplicației din fişierul specificat (overview.html). Calea către fişier 
este relativă în funcție de opțiunea -sourcepath. 

-public 

Generează documentaţie doar pentru clasele şi membrii public. 

-protected 

Afişează doar clasele şi membrii public şi protected. Această opțiune 
este implicită. 

-package 

Afişează doar pachetele, clasele şi membrii public şi protected. 

-private 

Afişează toate clasele şi toți membrii. 

-doclet numeClasa 

Este specificată clasa care execută doclet-ul folosit în generarea documen- 
tației. Calea către clasa de start a doclet-ului este specificată prin intermediul 
opțiunii -docletpath, urmată de calea respectivă. 

-sourcepath listaCaifisiereSursa 

Este specificată calea către fişierele sursă (. java), atunci când numele de 
pachete sunt folosite ca parametri. De exemplu, dacă se doreşte documenta- 
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rea unui pachet numit com .mypackage, ale cărui fişiere sursă sunt localizate 
la locaţia c:Nuserisrcicomimypackage*. java, atunci comanda ce 
trebuie executată arată astfel: 

c:i>javadoc -sourcepath c:luserisrc com.mypackage 

-classpath listaCaiClase 

Este specificată calea unde javadoc va căuta clasele referite (pentru detalii 
despre clasele referite, vezi secţiunile anterioare din această anexă). 

-Joptiune 

Lansează comanda java cu opţiunea specificată de argumentul optiune. 
De exemplu, pentru aflarea versiunii utilizate de javadoc, se execută co- 
manda: 

c:\> javadoc -J-version 

Trebuie reținut faptul că nu există nici un spațiu între opțiunea J şi argu- 
mentul optiune. 

Opțiunile prezentate anterior pot fi utilizate de javadoc indiferent de doclet- 
ul folosit în generarea documentației. Implicit, javadoc utilizează doclet-ul 
standard, care generează documentație în format HTML. Acest doclet oferă un 
alt set de opțiuni, care vine în completarea celui anterior. Iată câteva dintre 
aceste opțiuni: 

=d 

Este specificat directorul destinație, unde javadoc va salva documentația 
HTML generată. Dacă această opțiune nu este prezentă, atunci documentația va 
fi creată în directorul curent. 

-version 

Include textul asociat cu eticheta version în documentația HTML gene- 
rată 

-author 

Include textul asociat cu eticheta Qauthor în documentaţia HTML generată 

-splitindex 

Împarte alfabetic fişierul de index al documentaţiei în mai multe fişiere, câte 
unul pentru fiecare literă. 

-windowtitle text 

Este specificat titlul care va fi plasat în tag-ul <title> din HTML (denumi- 
rea ferestrei browser-ului). Acest titlu devine titlul ferestrei de browser, vizibil 
în colţul din stânga sus al ferestrei. 

-doctitle text 

Este specificat titlul documentului. 

-header text 

Este specificat textul care va fi plasat la începutul fiecărui fişier de docu- 
mentaţie generat. 
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-footer text 

Este specificat textul care va apărea în dreapta meniului de navigare din 
josul paginii. 

-bottom text 

Este specificat textul care va apărea la finalul fiecărui fişier generat. În ge- 
neral, aceste note de subsol conţin informaţii legate de copyright. 

-nodeprecated 

Elementele demodate (pachete, clase, membrii etc.) sunt omise la generarea 
documentaţiei. 


B.11.5 Exemple simple de utilizare javadoc 


Vom prezenta în final câteva exemple simple de folosire a utilitarului java- 
doc. Utilitarul poate fi rulat pe clase individuale sau pe pachete întregi de clase. 


e Crearea documentaţiei pentru unul sau mai multe pachete 


Pentru a documenta un pachet, fişierele sursă din acel pachet trebuie să 
existe într-un director cu acelaşi nume ca şi pachetul. Dacă pachetul 
este creat din mai multe nume, separate prin simbolul punct (.), fiecare 
nume reprezintă un director diferit. Astfel, toate clasele din pachetul 
java. awt trebuie să existe în directorul javalawti. 

Presupunem că directorul c : \home\src\java\awt\ este directorul 
în care sunt create fişierele sursă iar directorul destinaţie pentru docu- 
mentaţia generată este c: Vlhome html. Vom păstra această convenţie 
pentru toate exemplele de acest gen din anexa curentă. 

Documentaţia se poate crea în două moduri: 


— din directorul corespunzător pachetului: 


Ga > cad -Ct Vhome src 
c:> javadoc -d c: homelhtml java.awt 


— din orice director: 


c:\> javadoc -d c: homelhtml -sourcepath 
c:Nhomeisrc java.awt 


e Crearea documentaţiei pentru una sau mai multe clase 


Analog cazului 1, avem două modalităţi disponibile: 
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— din directorul cu fişiere sursă: 


c:\> cd c:\home\src\java\awt 
c:> javadoc -d c:\home\html Canvas.java 
Graphics*.java 


Se generează documentația pentru clasa Canvas şi pentru toate 
clasele al căror nume începe cu Graphics. Documentul HTML 
generat nu va mai avea trei frame-uri ca în cazul pachetelor, ci două, 
deoarece generarea s-a realizat pe clase şi nu pe pachete, situație în 
care al treilea frame (cel cu listarea pachetelor) este inutil. 


— din orice director: 


c:\> javadoc -d c:\home\html1 
c:\home\src\java\awt\Canvas. java 
c:\home\src\java\awt\Graphics*.java 


e Crearea documentației pentru pachete şi clase simultan 
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Combinarea celor două cazuri descrise anterior, conduce la: 


c:\> javadoc -d c:\home\html -sourcepath 
c:\home\src java.awt 
c:\home\src\java\applet\Applet.java 


Crearea documentației prin specificarea în linie de comandă a unui fişier 


Pentru a scurta sau simplifica o comandă javadoc, se pot specifica unul 
sau mai multe fişiere care conțin separat nume de fişiere sursă sau pa- 
chete, câte unul pe linie. La execuția comenzii, numele fişierelor trebuie 
precedat de simbolul @. 


De exemplu, fie fişierul packages, cu următorul conținut: 


com.packagel 
com.package2 
com.package3 


Se poate rula javadoc astfel (apidocs reprezintă numele directorului 
de destinaţie al documentaţiei generate, iar home src constituie direc- 
torul în care se află fişierul packages, dar şi directorul com, cu subdi- 
rectoarele package1, package2, package3): 
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C: \> ele C: \homesre 
c:> javadoc -d apidocs (packages 


e Salvarea mesajelor de eroare generate de execuția javadoc într-un fişier 
separat (valabil doar pe Windows NT) 


Pentru a redirecta eventualele mesaje de eroare generate de execuția comen- 
zii javadoc, se poate utiliza comanda: 


c:\> javadoc -d docs java.lang >log.std 2>log.err 
sau, forma restrânsă: 
c:\> javadoc -d docs java.lang >javadoc.log 2>&1 


Prima variantă redirecționează mesajele standard în fişierul 1og. std, 
iar pe cele de eroare în log.err, în timp ce în al doilea caz, ambele 
tipuri de mesaje sunt redirecționate către fişierul javadoc. log. 

e Utilizarea din alte programe a comenzii javadoc 
Se poate folosi o secvență de cod de genul: 


1 void metoda () 


2 | 


3 String [] javadocArguments = { 

4 "—sourcepath", 

5 "c:\home\src", 

6 "od", 

7 "c:\home\html", 

8 "java.awt" 

9 ); 

10 com . sun. tools .javadoc. Main. main (javadocArgumenits ); 
11 

12 // continuare cod... 


Dezavantajul unei astfel de utilizări este că metoda main nu returnează 
nimic, de aceea nu se poate determina dacă javadoc s-a executat cu 
succes sau nu. 
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Jar 


Simplificaţi lucurile atât cât este 
posibil, dar nu mai mult. 


Albert Einstein 


C.1 Prezentare generală a pachetelor Java prede- 
finite 


Mediul de programare Java oferă o serie de clase predefinite pentru a veni 
în întâmpinarea programatorilor care doresc să realizeze aplicaţii la standarde 
profesionale. Scopul pentru care aceste clase au fost implementate de creatorii 
limbajului Java, a fost acela de a uşura pe cât posibil munca programatorilor, 
care nu mai sunt obligaţi în acest fel "să reinventeze roata". Programatorii fo- 
losesc aceste clase, dar îşi pot defini pe baza lor şi propriile lor clase, specifice 
aplicaţiilor pe care le realizează. 

Mulțimea claselor oferite de limbajul Java poartă numele de Java 2 API (Ap- 
plication Programming Interface). API-ul Java oferă facilităţi foarte puternice, 
des utilizate de programatori. Putem spune cu certitudine că orice program Java 
utilizează din abundență API-ul Java. Dată fiind importanţa lui, este evident 
că documentaţia API-ului capătă şi ea o însemnătate deosebită. Documentaţia 
poartă numele Java 2 API Specification şi poate fi găsită în cadrul documentaţiei 
J2SDK. 

Pentru o mai bună organizare, clasele oferite de limbajul Java au fost îm- 
părţite în pachete, având drept criteriu de departajare funcţionalitatea oferită. 


ege w,’ 
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recţii, cum ar fi: applet-uri, aplicaţii de tip desktop folosind AWT, aplicaţii 
Swing bazate pe JFC, RMI (Remote Method Invocation), securizarea aplicaţi- 
ilor, utilizarea bazelor de date, internaţionalizarea aplicaţiilor, crearea de arhive 
JAR şi ZIP, suport pentru CORBA, etc. Multitudinea de direcţii în care s-a dez- 
voltat Java este observabilă şi în numărul mare de pachete pe care îl pune la 
dispoziţia programatorilor: peste 70 de pachete. Numărul este impresionant 
şi devine evident faptul că nu putem prezenta informaţii despre fiecare pachet 
în parte. Totuşi, în cele ce urmează vom descrie cel mai des utilizate pachete, 
împreună cu câteva dintre cele mai reprezentative clase conţinute. 

Iată o listă a celor mai des utilizate pachete (în cadrul acestei lucrări sunt 
folosite doar clase din cadrul primelor cinci pachete): 


e java.lang,care oferă clase fundamentale pentru limbajul Java; 


e java.util conţine clase pentru utilizarea colecţiilor, pentru manevra- 
rea datelor calendaristice şi a timpului, pentru internaţionalizarea apli- 
caţiilor etc.; 


e java.io, care oferă modalităţi de citire/scriere a datelor prin inter- 
mediul fluxurilor de date, a serializării sau a fişierelor; 


e java.math, care oferă clase specializate în calcul matematic; 


e java.text, care oferă clase pentru manevrarea textului, a datelor ca- 
lendaristice, a timpului şi a mesajelor într-o manieră independentă de 
limba utilizată, fie ea engleză, franceză, română etc.; 


e java.net, care pune la dispoziţia programatorilor clase pentru imple- 
mentarea aplicaţiilor de reţea; 


e java.util.jar,care oferă clase pentru citirea şi scrierea fişierelor în 
format JAR (Java Archive), bazat pe formatul standard ZIP; 


e java.util.zip,care oferă clase pentru citirea şi scrierea de arhive în 
format ZIP sau GZIP. 


Iată şi câteva dintre cele mai reprezentative clase pentru fiecare dintre aceste 
pachete: 


e java.lang 


- Boolean,Byte,Character,Double,Ffloat, Integer, Long, 


Short, asociate tipurilor primitive respective: byte, char, double 
etc.; 
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— Math, asigură realizarea unor operaţii aritmetice elementare: mo- 
dulul, funcţii trigonometrice, exponenţiale, maximul şi minimul a 
două numere, aproximări etc.; 


— String, StringBuffer, pentru administrarea şirurilor de ca- 
ractere; 


— System, oferă facilități de acces la fluxurile standard de intrare 
(in), ieşire (out) şi eroare (err)etc.; 


— Thread, asigură facilităţi pentru lucrul cu fire de execuţie în Java. 
e java.util 


— Calendar, pentru administrarea datelor calendaristice; 


— Date, reprezintă o dată calendaristică în timp, cu precizie la nivel 
de milisecunde; 


— Hashtable, pentru reprezentarea tabelelor de repartizare; 
— LinkedList, pentru administrarea listelor înlănţuite; 


— Locale, pentru reprezentarea unei zone politice, geografice sau 
culturale; 


— ListResourceBundle,PropertyhResourceBundle sau Re- 
sourceBundle, pentru reprezentarea colecţiilor de resurse; 


— Stack, pentru administrarea unei stive (listă în format LIFO, Lastin- 
FirstOut); 


— Vector, implementează un şir de obiecte de dimensiune variabilă. 
e java.io 


— BufferedReader, citeşte text de la un flux de intrare a datelor, 
depunând informaţia citită într-un buffer pentru a realiza o citire 
eficientă a caracterelor, şirurilor, stringurilor; 


— Bufferedwriter, scrie text către un flux de ieşire a datelor, de- 
punând informaţia scrisă într-un buffer pentru a realiza o scriere 
eficientă a caracterelor, şirurilor, stringurilor; 


— File, care asigură gestionarea fişierelor, inclusiv a locaţiilor unde 
acestea se găsesc; 


— FilelIlnputStream, asigură citirea de date sub forma unor şiruri 
de bytes dintr-un fişier specificat; 
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— FileCutputStreanm, asigură scrierea de şiruri de bytes într-un 
fişier specificat, 


e java.math 


- BigDecimal,BigInteger, care permit calculul cu numere foar- 


te mari, care nu ar "încape" în reprezentarea obişnuită a numerelor 
în Java. 


e java.text 


— ChoiceFormat, permite ataşarea de formate de mesaje în funcţie 
de diverse valori ale unor variabile; 


- DateFormat, asigură formatarea datelor calendaristice şi a tim- 
pului într-o manieră independentă de limba utilizată; 


— MessageFformat, permite formatarea mesajelor independent de 
limbă; 

— NumberFormat, permite formatarea numerelor, a procentelor şi a 
sumelor de bani independent de limbă; 


e java.net 
— HttpURLConnection, oferă facilităţi pentru conectarea prin re- 


tea la un server HTTP şi adresarea unei cereri serverului respectiv; 


— InetAddress, pentru administrarea unei adrese IP (Internet Pro- 
tocol); 


— URL, pentru administrarea unei adrese URL (Uniform Resource Lo- 
cator), care indică o resursă Internet. 


e java.util.jar 


— JarFile, pentru administrarea unui fişier JAR; 


— JarInputStream, oferă facilități de citire a conținutului unui 
fişier JAR; 


— JarOutputStream, oferă facilități de scriere a unui fişier JAR. 


e java.util.zip 


— ZipFile, pentru administrarea unei arhive ZIP; 
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— ZiplnputStreanm, oferă facilități de citire a conţinutului unei 
arhive ZIP; 


— ZipOutputStream, oferă facilităţi de scriere a unei arhive ZIP. 


Dintre pachetele prezentate, două se detaşează prin gradul foarte mare de uti- 
lizare, indiferent de natura aplicaţiei care se crează. Este vorba despre pachetele 
java.lang şi java.util. Aşa cum am precizat, pachetul java.lang 
este importat implicit în orice aplicaţie Java, drept urmare programatorul poate 
folosi clasele sale fără a fi nevoie să le importe explicit. 


C.2 Definirea de pachete de câtre utilizator 


Secţiunea de faţă prezintă un exemplu simplu, dar detaliat, de creare şi uti- 
lizare a propriilor pachete. Mediul de programare Java oferă spre utilizare pro- 
gramatorului, o mulţime de pachete împreună cu clasele aferente (de exemplu, 
java.util, java.math etc.). Dar pentru că această facilitate nu este în- 
totdeauna suficientă, mediul Java permite definirea propriilor pachete. Cu alte 
cuvinte, programatorului Java îi este permis să îşi organizeze clasele definite de 
el în pachete proprii. 

Exemplul ales utilizează trei pachete: 


e com.test.masini 
e com.test.posesori 
e com.test 


Primul pachet, com.test .masini,va îngloba clase cu funcţionalitate apropi- 
ată, reprezentând diverse tipuri de maşini. Aşadar, vom avea clasele Dacia 

şi Ferrari. Al doilea pachet, com.test.posesori, va cuprinde clase 

care descriu posesorii automobilelor din primul pachet. Printre aceste clase se 

numără: Persoana, clasă asociată unei persoane fizice şi Firma, clasă aso- 

ciată unei persoane juridice (firme). 

Programul principal, cu alte cuvinte clasa ExempluPachete, se va afla 
în pachetul com. test şi va utiliza clase din celelalte două pachete. Pentru că 
definirea pachetelor are o influenţă decisivă asupra locației unde trebuie să fie 
salvate fişierele sursă ale acestei aplicaţii de test, considerăm directorul de lucru 
c:Njavawork (pentru utilizatorii de Windows). Analog, utilizatorii altor sis- 
teme de operare, vor putea implementa exemplul ales, considerând un director 
de lucru specific platoformei respective (/usr/local/javawork este un 
exemplu pentru platforma Linux). 
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Câteva detalii despre pachete sunt necesare în acest moment al construirii 
aplicaţiei. În primul rând, numele pachetelor trebuie să fie unice, pentru a evita 
eventualele conflicte care pot să apară la încărcarea claselor. Existenţa a două 
pachete cu acelaşi nume pune maşina virtuală Java în situaţia de a nu şti ce 
clase să încarce, din primul pachet sau din al doilea. Consecința imediată este 
faptul că nu se pot crea pachete cu acelaşi nume ca al pachetelor predefinite 
de mediul de programare Java (de exemplu java.lang, java.util etc). 
Sarcina de a găsi un nume unic pentru fiecare pachet poate fi uşurată dacă sunt 
respectate convențiile de programare Java (detalii în anexa B). Potrivit aces- 
tor convenţii, putem crea pachete pornind de la domeniul Internet deţinut, în 
cazul în care programatorul/firma deţine un astfel de nume (de exemplu pa- 
chetul ro. firmamea provine de la domeniul www. firmamea.ro). Dacă 
nu există un domeniu Internet, este necesară crearea unei combinaţii de nume, 
care este puţin probabil să se repete. Afirmațiile anterioare sunt utile mai ales în 
cazul în care aplicaţiile create de dumneavoastră sunt redistribuite către diverşi 
utilizatori, care ar putea folosi la rândul lor alte pachete, de la alţi furnizori. Ex- 
emplul nostru fiind unul de test, am ales ca nume de pachet com. test, nume 
care poate asigura unicitatea la nivelului calculatorului pe care realizăm apli- 
caţiile Java de test, deşi nu este personalizat cu informaţii cu caracter unic (de 
exemplu, numele persoanei sau al firmei care l-a creat). 

Numele pachetului presupune crearea unei ierarhii de directoare conformă 
cu el. În cazul nostru, cele trei pachete existente com. test, com.test .ma- 
sini şi com.test.posesori, presupun crearea următoarelor directoare: 
com, comltest, comitest masini şi comltestiposesori, conform 
ierarhiei: 


-com 


— test 
| 
- masini 
| 


- posesori 


Cele patru directoare sunt create în cadrul directorului de lucru stabilit ante- 
rior (c : \javawork). In fiecare dintre aceste directoare se află fişierele sursă 
ale claselor precizate anterior, în funcţie de pachetul în care sunt definite: 


e Dacia.java,Ferrari. java se găsesc în directorul 
c:|javaworkicomitestimasini; 
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e Persoana.javaşi Firma. java în directorul 
c:|javawork |comitest posesori; 


e ExempluPachete. java în directorul c: |javaworkicomitest. 


Codul sursă al acestor fişiere este prezentat în continuare: 


Listing C.1: Codul sursă al clasei Dacia 


1 // Fisierul comitest masini Dacia. java 

2 package com. test.masini; 

3 

4 public class Dacia 

s { 

6 /x* Modelul masinii (1310, 1300, Berlina, etc.).+*/ 
7 private String tip; 
8 
9 


10 /*xx* Creaza o Dacie cu modelul precizat. x/ 
T public Dacia( String tipul) 

12 { 

13 tip = tipul; 

14 } 

15 

16 /xx Returneaza tipul masinii. */ 
17 public String returneazaTip() 
18 { 

19 return tip; 

20 } 


Listing C.2: Codul sursă al clasei Ferrari 


ı // Fisierul com\test\masini\ Ferrari. java 
2 package com. test .masini; 

3 

4 public class Ferrari 


s { 
/x» Modelul masinii (F50, etc.).*/ 


6 
7 private String tip; 

8 

9 

10 /xx Creaza un Ferrari cu modelul precizat. */ 


LI public Ferrari(String tipul) 
12 { 


13 tip = tipul; 

14 } 

15 

16 /xx Returneaza tipul masinii. */ 
17 public String returneazaTip() 
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18 í 

19 return tip; 
20 } 

2i} 


Listing C.3: Codul sursă al clasei Persoana 


ı// Fisierul com\test\posesori\Persoana . java 
2 package com. test .posesori; 


4import com. test.masini.*; 
import java.util.x; 


5 
6 
7 public class Persoana 
8 
9 


{ 
/x» Numele persoanei. */ 
10 private String nume; 
lI 
12 /x*x»*» Adresa persoanei. */ 
13 private String adresa; 
14 
15 /xx* Sir cu masinile Dacia detinute de persoana*/ 
16 private Vector masini; 
17 
18 
19 /*x * Creaza o persoana cu numele si adresa specificate. x/ 
20 public Persoana( String numele, String adresa_) 
21 { 
22 nume = numele; 
23 adresa = adresa_; 
24 masini = new Vector); 
25 } 
26 
27 /xx Returneaza nume. */ 
28 public String returneazaNume () 
29 | 
30 return nume; 
31 } 
32 
33 /xx Adauga o masina Dacia celor aflate deja in posesie. x*/ 
34 public void adaugaDacia(Dacia masina) 
35 { 
36 masini .add (masina ); 
37 } 
38 
39 /x» Returneaza masinile aflate in posesie.x/ 
40 public Vector returneazaMasini () 
4l í 
42 return masini; 
43 } 
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Listing C.4: Codul sursă al clasei Firma 


1 // Fisierul comitest posesori Firma. java 
2 package com.test.posesori; 


4 import java.util.x; 

s import com.test.masini.x; 

6 

7 public class Firma 

s | 

9 /xx Numele firmei. */ 

10 private String nume; 

lI 

12 /xx Numar angajati. x*/ 

13 private int numarAngajati; 

14 

15 /xx Sir cu masinile aflate in posesie.x/ 
l6 private Vector masini; 

17 

18 

19 /*x* 

20 x Creaza o firma specificand numele si 
21 x numarul de angajati. 

22 x / 

23 public Firma(String numele, int numarulAngajatilor) 
24 { 

25 nume = numele; 

26 numarAngajati = numarulAngajatilor ; 
27 masini = new Vector (); 

28 } 

29 

30 /x» Adauga un Ferrari celor aflate deja in posesie.*/ 
31 public void adaugaFerrari (Ferrari masina) 
32 { 

33 masini .add( masina ); 

34 } 

35 

36 /*xx* Returneaza nume. */ 

37 public String returneazaNume () 

38 { 

39 return nume; 

40 ) 

4l 

42 /xx Returneaza masinile aflate in posesie.x/ 
43 public Vector returneazaMasini () 

44 { 

45 return masini; 

46 } 


C.2. DEFINIREA DE PACHETE DE CĂTRE UTILIZATOR 


Listing C.5: Utilizarea claselor din pachetele definite 


1// Fisierul comitestiExempluPachete . java 
2 package com.test; 


+ import com. test.masini.x; 


s import com.test.posesori.x; 

6 import java.util.x; 

7 

s public class ExempluPachete 

o { 

10 public static void main(String [] args) 

Ll í 

12 Persoana p = new Persoana("Mircea Ionescu", ""); 

13 Dacia d = new Dacia("1300"); 

14 

15 // persoana P detine masina d 

16 p.adaugaDacia (d); 

17 Vector v = p.returneazaMasini (); 

18 

19 // afisarea tipurilor masinilor detinute de persoana 
20 System.out.printin("Tipurile de masini detinute de " 
2l + p.returneazaNume () + ": "); 

22 for(int i = 0; i < v.size(); i++) 

23 { 

24 String tip = ((Dacia) v.get(i)). returneazaTip (); 
25 System.out.print(tip +" "); 

26 } 

27 System.out.println(""); 

28 

29 Firma firmaMea = new Firma("Sun", 13000); 

30 Ferrari f = new Ferrari ("F50"); 

31 

32 // firma firmaMea detine masina f 

33 firmaMea . adaugaFerrari(f); 

34 v = firmaMea. returneazaMasini (); 

35 

36 System .out.println("Tipurile de masini detinute de " 
37 + firmaMea .returneazaNume () + ": "); 

38 for(int i = 0; i < v.size(); i++) 

39 | 

40 String tip = ((Ferrari) v.get(i)). returneazaTip (); 
4l System . out. print(tip +" "); 

42 } 

43 } 

a ) 


După ce clasele au fost create, următoarea acţiune constă în setarea vari- 
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abilei de sistem CLASSPATH, prezentată în cadrul capitolului 4.4.3. Variabila 
CLASSPATH trebuie astfel setată încât să conţină şi directorul de lucru pen- 
tru aplicaţia noastră de test. Pentru aceasta, utilizatorii de Windows execută 
următoarea comandă în cadrul unui prompt MS-DOS: 


set CLASSPATH=S$CLASSPATH$;c: javaworki 


Pentru a verifica dacă variabila CLASSPATH a fost actualizată, se lansează 
în acelaşi prompt MS-DOS comanda: 


echo CLASSPATH 
Comanda afişează informaţii asemănătoare cu cele ce urmează: 


ee ADOR ID VE0O Seat) AK NIPENLIDIL Ca jar; 
c: javaworki 


Dacă printre locaţiile afişate se află directorul de lucru, atunci se poate trece 
la pasul următor. 

Următorul pas constă în compilarea claselor definite în cadrul celor trei 
pachete care compun exemplul. Pentru ca procesul de compilare să fie mai 
uşor, se crează un fişier cu numele fisiereSursa, în directorul de lucru 
(c:|javawork), având următorul conţinut: 


comitest VLExempluPachet. java 
comitest masini NDacia.java 
comitestimasini Ferrari. java 
comitest posesori Persoana. java 
comltestiposesori Firma. java 


Apoi, în acelaşi prompt MS-DOS în care s-a setat variabila CLASSPATH, 
se compilează fişierele sursă ale aplicaţiei test, utilizând din directorul de lucru 
comanda: 


javac (fisiereSursa 


Este foarte important ca toate comenzile să fie executate în acelaşi prompt 
MS-DOS în care s-a setat variabila CLASSPATH, pentru că această setare este 
valabilă doar în cadrul acelui prompt. În momentul în care promptul respec- 
tiv este închis, se pierde modificarea realizată asupra variabilei CLASSPATH, 
revenindu-se la valoarea iniţială. Pentru a face aceste modificări permanente, 
ele trebuie să fie efectuate în: 
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e fişierul autoexec .bat din directorul rădăcină, în cazul sistemelor Win- 
dows 95, 98, ME, urmate de repornirea calculatorului; 


e secțiunea User VariablesdinControl Panel-> System-> 
Environment, în cazul sistemelor Windows NT, 2000. 


Deoarece numărul de fişiere sursă este destul de mic pentru acest exemplu, folo- 
sirea comenzii anterioare este acceptabilă. Dar, dacă aplicaţia pe care o realizaţi 
are un număr mare de clase, atunci este recomandat să utilizaţi utilitarul ant, 
prezentat în anexa A, pentru a compila fişierele aflate într-o ierarhie de direc- 
toare. 

Prin compilare, se crează fişierele .class respective, în cadrul aceloraşi 
directoare cu cele sursă. Dacă se doreşte separarea fişierelor sursă de cele 
„class, atunci comanda javac trebuie folosită cu opţiunea -d, urmată de 
directorul unde vor fi create fişierele .class. Trebuie menţionat că acest nou 
director nu este automat precizat în variabila CLASSPATH. De aceea, dacă op- 
taţi pentru această variantă, va trebui să adăugaţi personal directorul respectiv 
în cadrul variabilei CLASSPATH. 

Exemplul construit în această secţiune se execută prin rularea în directorul 
de lucru a comenzii: 


java com.test.ExempluPachet 
Rezultatele afişate sunt: 


Tipurile de masini Dacia detinute de Mircea Ionescu: 
1300 

Tipurile de masini Ferrari detinute de Sun: 

F50 


Pentru a înțelege în profunzime modul de lucru cu pachete, să vedem cum 
găseşte Java pachetele şi clasele definite de programator. Mai întâi, interpretorul 
Java (java) caută variabila de sistem CLASSPATH. Pornind de la rădăcină, 
interpretorul preia, pe rând, fiecare nume de pachet şi înlocuieşte fiecare sim- 
bol "." întâlnit cu simbolul "\" sau "/" în funcție de sistemul de operare 
pe care rulează, pentru a genera o cale relativă unde vor fi căutate fişierele 
.class. În cazul nostru, pachetul com.test.masini este transformat în 
com\test\masini. Apoi, această cale relativă este concatenată la diferitele 
intrări din variabila de sistem CLASSPATH, de exemplu c :\javawork sau 
c:\jdk\lib\tools. jar etc. Fiecare dintre aceste concatenări nu reprezin- 
tă altceva decât căi absolute, unde interpretorul caută fişierele .class (adică 
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Dacia.class, Ferrari.class). Pentru exemplul nostru, interpretorul 
găseşte fişierele anterioare în directorul c : |javawork|comitest masini. 

În acest moment se poate spune că primele pachete realizate de dumnea- 
voastră sunt funcţionale. Exemplul ales a fost însă unul simplu pentru a putea 
înţelege paşii necesari de la crearea pachetelor şi până la rularea aplicaţiei care 
le foloseşte. Cu siguranţă că de-a lungul timpului nu vă veţi opri aici şi acest 
exemplu va fi urmat de altele, conţinând ierarhii de pachete din ce în ce mai 
complexe. 


C.3 Arhive jar (Java ARchives) 


Arhivele jar permit gruparea mai multor fişiere într-un sigur fişier arhivat. 
În mod obişnuit fişierele conţinute de o arhivă jar sunt fişiere . clas s, împre- 
ună cu diverse resurse care pot fi asociate cu o aplicaţie (imagini, etc.). Nu există 
o interdicţie în ceea ce priveşte tipul de fişiere conţinute de o arhivă jar (aces- 
tea pot conţine orice tip de fişiere, ca de altfel orice alt format de arhivare, cum 
ar fi zip, rar, ace, arj etc.), dar în general sunt folosite fişierele .class. 
Arhivele jar oferă programatorilor anumite beneficii: 


e compresie: arhivele jar permit compresarea fişierelor pentru a fi stocate 
mai eficient; 


e simplificarea distribuirii aplicaţiilor: aplicaţia creată este distribuită cli- 
enţilor sub forma unui singur fişier jar, care înglobează toate fişierele şi 
resursele necesare funcţionării aplicaţiei; 


e micşorarea timpului de transfer: pentru a fi descărcate fişierele conţinute 
de un fişier jar, este nevoie doar de o singură conexiune HTTP şi nu de 
câte o conexiune pentru fiecare fişier în parte; 


e portabilitate: ca parte a platformei Java, arhivele jar sunt portabile, 
putând fi utilizate fără a fi modificate pe orice platformă cu suport Java; 


e extinderea funcţionalităţii platformei Java: mecanismul de extindere o- 
ferit de platforma Java permite extinderea funcţionalităţi platformei prin 
adăugarea unor fişiere jar celor existente (printre arhivele existente în 
orice implementare Java se numără şi rt. jar, ce conţine API-ul Java 
predefinit, adică toată ierarhia de clase pe care mediul Java o oferă spre 
utilizare programatorilor). Prin adăugarea unor arhive noi, puteţi să extin- 
deţi funcţionalitatea platformei Java. Un exemplu este extensia JavaMail, 


322 


C.3. ARHIVE JAR (JAVA ARCHIVES) 


dezvoltată de Sun, care reprezintă un API utilizat în programele Java pen- 
tru transmiterea şi recepţionarea de email-uri; 


e versionarea pachetelor de clase: un fişier jar poate cuprinde date despre 
fişierele pe care le conţine, cum ar fi informaţii despre cel care a creat 
pachetele şi despre versiunea pachetelor respective. 


C.3.1 Utilizarea fişierelor . jar 


Fişierele jar sunt arhivate pe baza formatului zip, deci au aceleaşi faci- 
lităţi ca orice alt tip de arhivă (compresie fără pierderea datelor etc.). Pe lângă 
aceste facilităţi de bază, fişierele jar au şi alte funcţionalităţi mai avansate 
(rularea unei aplicaţii în format jar este una dintre ele), a căror înțelegere 
este condiţionată de familiarizarea cu operaţiile fundamentale cu arhive jar: 
crearea unei arhive jar, vizualizarea, extragerea sau modificarea conţinutului 
acesteia. 

Operaţiile de bază cu arhivele jar se realizează folosind o aplicaţie utilitară 
oferită de platforma Java. Această aplicaţie utilitară este în linie de comandă 
şi este denumită jar, putând fi găsită în directorul bin al distribuţiei Java 
instalată pe calculatorul dumneavoastră. Pentru a testa prezenţa utilitarului pe 
calculatorul dumneavoastră, deschideţi o fereastră de comandă (sau, altfel spus, 
un prompt) şi rulaţi comanda jar. Implicit, vor fi afişate informaţii ajutătoare 
despre această comandă, cum ar fi opţiunile de utilizare şi câteva exemple. 

Iată, pentru început, un rezumat al celor mai frecvente operaţii cu arhive 
jar: 

e crearea unei arhive jar (cu alte cuvinte, "împachetarea" fişierelor şi a di- 

rectoarelor într-un singur fişier); 


e vizualizarea conţinutului unei arhive jar; 

e extragerea conţinutului unei arhive jar; 

e extragerea doar a anumitor fişiere conţinute într-o arhivă jar; 
e modificarea conţinutului unei arhive jar; 


"A 


e rularea unei aplicații "“împachetate" într-o arhivă jar; 


C.3.2 Crearea unui fişier . jar 


O arhivă jar este realizată utilizând aplicația utilitară jar în următoarea 
formă: 
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jar cf nume_fisier_jar nume_ fisiere 


Opțiunile şi argumentele utilizate în această comandă au următoarea sem- 
nificaţie: 


e opţiunea c indică faptul că este creată o arhivă jar; 


e opţiunea f indică faptul că arhiva este creată într-un fişier. Este important 


de reţinut faptul că opţiunile nu trebuie separate prin spaţiu şi că ordinea 
de apariţie a lor nu contează; 


argumentul nume_fisier_jar reprezintă numele fişierului jar rezul- 
tat în urma arhivării. Poate fi folosit orice nume pentru a denumi un fişier 
jar. Prin convenţie, fişierele au extensia . jar, deşi acest lucru nu este 
obligatoriu; 


argumentul nume_fisiere reprezintă o listă de nume de fişiere şi di- 
rectoare, separate prin spaţiu, care vor fi introduse în arhivă. Numele 
acestora poate să conţină şi simbolul *, pentru a face referire la mai 
multe fişiere în acelaşi timp. În cazul directoarelor, conţinutul acestora 
este adăugat recursiv la arhivă; 


Suplimentar, se pot folosi şi alte opţiuni, pe lângă cele de bază (cf): 


e opţiunea v afişează numele fiecărui fişier adăugat la arhivă, în timpul 


creării acesteia; 
opţiunea 0 indică faptul că arhiva nu va fi compresată; 


opţiunea M indică faptul că fişierul manifest asociat arhivei nu este creat 
(detalii despre fişierele manifest sunt oferite mai târziu în cadrul secţiunii 
curente); 


opţiunea m indică faptul că pot fi preluate dintr-un fişier manifest existent 
informaţii necesare arhivei care va fi creată. In acest caz, comanda are 
următoarea formă: 


jar cfm nume_fisier_manifest nume_fisier_jar 
nume_fisiere 


e opţiunea -C schimbă directorul curent în timpul execuţiei comenzii. 
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În continuare vom prezenta câteva exemple de creare a arhivelor jar, care uti- 
lizează fişierele .class ale aplicaţiei de test cu maşini şi posesori, prezentată 
în subcapitolul precedent. Aceste fişiere se află conform celor stabilite în sub- 
capitolul precedent, în directorul c : |javawork, care are următoarea structură 
(pentru simplitate, sugerăm mutarea celorlalte tipuri de fişiere în alt director): 


— com 
— test 

- masini 
- Dacia.class 
- Ferrari.class 

- posesori 
- Firma.class 
- Persoana.class 

—- ExempluPachete.class 


În primul exemplu de creare a arhivelor jar, în directorul c : \javawork 
se lansează dintr-o fereastră de comandă aplicația jar astfel: 


jar cvf pachete.jar com 
In fereastra de comandă se va vedea ceva asemănător cu textul următor: 


added manifest 

adding: com/(in = 0) (out= 0) (stored 0%) 

adding: com/test/(in = 0) (out= 0) (stored 0%) 
adding: com/test/masini/(in = 0) (out= 0) (stored 0%) 
adding: com/test/masini/Dacia.class(in = 364) 

(out= 257) (deflated 2935) 

adding: com/test/masini/Ferrari.class(in = 368) 
(out= 259) (deflated 29%) 

adding: com/test/posesori/(in = 0) (out= 0) (stored 0%) 
adding: com/test/posesori/Persoana.class(in = 738) 
(out= 432) (deflated 415) 

adding: com/test/posesori/Firma.class(in = 730) 
(out= 439) (deflated 39%) 

adding: com/test/ExempluPachete.class(in = 1602) 
(out= 913) (deflated 435) 


Deoarece com este un director, utilitarul jar a adăugat recursiv toate di- 
rectoarele şi fişierele conținute în el. Rezultatul execuției acestei comenzi este 
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fişierul pachete. jar, aflat în directorul curent, în care a fost lansată co- 
manda. Analizând textul afişat se poate observa că fişierul proaspăt creat este 
comprimat. 

Există şi posibilitatea de a crea o arhivă pachete. jar necomprimată. 
Pentru aceasta se lansează comanda: 


jar cvfO pachetel.jar com 
Aceasta afişează următorul text: 


added manifest 

adding: com/(in = 0) (out= O) (stored 0%) 

adding: com/test/(in = 0) (out= 0) (stored 0%) 

adding: com/test/masini/(in = 0) (out= 0) (stored 0%) 
adding: com/test/masini/Dacia.class(in = 364) 

(out= 364) (stored 05) 

adding: com/test/masini/Ferrari.class(in = 368) 

(out= 368) (stored 05) 

adding: com/test/posesori/(in = 0) (out= 0) (stored 0%) 
adding: com/test/posesori/Persoana.class(in = 738) 
(out= 738) (stored 05) 

adding: com/test/posesori/Firma.class(in 
(out= 730) (stored 05) 

adding: com/test/ExempluPachete.class(in = 1602) 
(out= 1602) (stored 05) 


730) 


Am ales să dăm o altă denumire arhivei din al doilea exemplu, pentru a 
putea compara dimensiunile celor două fişiere jar rezultate. Dacă cel com- 
primat, denumit pachete.jar, are 3.792 de bytes, cel necomprimat, 
pachete1.jar,are 5.180 de bytes. 

Puteţi să creaţi o arhivă jar folosind simbolul *, ca în exemplul următor: 


jar cvf pachete.jar * 


Cu ajutorul acestui simbol sunt adăugate în arhivă toate fişierele şi (recursiv) 
directoarele din directorul curent. 

Ultimul exemplu pe care îl prezentăm foloseşte opţiunea -C, de schimbare 
a directorului curent. Prin utilizarea acestei opţiuni, căile relative nu mai sunt 
păstrate în totalitate în cadrul fişierului jar. Pentru a observa acest comporta- 
ment al utilitarului jar, lansați comanda: 


jar cvf pachete.jar -C comitesti 
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In fereastra de comandă se va afişa: 


added manifest 

adding: masini/(in = 0) (out= 0) (stored 0%) 

adding: masini/Dacia.class(in = 364) (out= 257) 
(deflated 29%) 

adding: masini/Ferrari.class(in = 368) (out= 259) 
(deflated 295) 

adding: posesori/(in = 0) (out= 0) (stored 0%) 
adding: posesori/Persoana.class(in = 738) (out= 432) 
(deflated 415) 

adding: posesori/Firma.class (in 
(deflated 395) 

adding: ExempluPachete.class(in 
(deflated 435) 


730) (out= 439) 


1602) (out= 913) 


Cu alte cuvinte, în timpul execuției comenzii, directorul curent a fost schim- 
bat în com\test, iar fişierele şi directoarele au fost adăugate ca şi cum co- 
manda ar fi fost executată în acel director. Utilitatea acestei opțiuni apare în 
momentul în care se adaugă mai multe fişiere şi directoare la o arhivă, deoarece 
atunci se poate schimba dinamic, dintr-o singură comandă, directorul curent de 
execuție a utilitarului jar. 


C.3.3 Vizualizarea conținutului unui fişier . jar 


Conţinutul unui fişier jar poate fi vizualizat fără a-l extrage propriu-zis 
din interiorul fişierului. Comanda standard utilizată pentru a realiza acest lucru 
este: 


jar tf nume_fisier_jar 


Opțiunile şi argumentele utilizate de această comandă au următoarea sem- 
nificaţie: 


e opţiunea t indică faptul că se doreşte vizualizarea conţinutului unui fişier 
jar; 


e opțiunea f indică faptul că în linia de comandă va fi specificat un nume 
de fişier, al cărui conținut va fi afişat; 


e argumentul nume_fisier_jar reprezintă numele fişierului jar al 
cărui conținut va fi afişat. 
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Suplimentar, se poate utiliza şi opţiunea v pentru a obţine informaţii despre 
dimensiunea fişierelor care intră în componenţa arhivei jar şi data în momentul 
ultimei modificări la care au fost supuse. 

Ca exemplu, lansați în directorul c : |javawork următoarea comandă pen- 
tru a vedea care este conţinutul arhivei pachete. jar, creată la secţiunea an- 
terioară (primul exemplu din suită): 


jar tf pachete.jar 


Rezultatul execuţiei acestei comenzi este următorul: 


ME TA- INF / 

META- INF /MANIFEST.MF 

com/ 

com/test/ 

com/test/masini/ 
com/test/masini/Dacia.class 
com/test/masini/Ferrari.class 
com/test/posesori/ 
com/test/posesori/Persoana.class 
com/test/posesori/Firma.class 
com/test /ExempluPachete.class 


După cum se poate observa, este afişat fiecare director şi fişier conţinut în 
fişierul jar. Directorul META- INF şi fişierul MANIFEST .MF, conţinut în 
acest director, reprezintă o componentă specială a oricărui fişier jar (paragra- 
ful C.3.5), fiind plasate în fişier la momentul creării acestuia. De asemenea, 
este util de reţinut că toate directoarele şi fişierele listate au căi relative, de tipul 
celei de mai jos: com/test/masini/Dacia.class. 


C.3.4 Extragerea conţinutului unui fişier . jar 


Forma standard a comenzii cu ajutorul căreia se extrage conţinutul unui 
fişier jar este următoarea: 


jar xf nume_fisier_jar [nume_fisiere_arhivate] 
Opțiunile şi argumentele utilizate au semnificaţia: 


e opţiunea x indică faptul că este extras conţinutul unui fişier jar; 


e opţiunea f specifică faptul că fişierul jar al cărui conţinut va fi extras, 
este specificat în linie de comandă; 
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e argumentul nume_fisier_jar reprezintă numele fişierului al cărui 
conţinut va fi extras; 


e argumentulnume_fisiere_arhivateesteun argument opțional (mo- 
tiv pentru care apare între caracterele [ ]), reprezentând lista cu numele 
fişierelor care vor fi extrase din fişierul jar, separate prin spaţiu. Dacă 
argumentul lipseşte, atunci va fi extras întreg conţinutul fişierului jar. 


Când extrage conţinutul unui fişier jar, utilitarul jar crează copii ale fişierelor 
şi directoarelor care sunt extrase, reproducând structura de directoare pe care 
fişierele o au în cadrul arhivei. Toate aceste copii sunt create în directorul curent, 
fişierul jar rămânând intact. Însă, dacă există fişiere cu acelaşi nume în direc- 
torul curent, ele vor fi rescrise. 

Ca exemplu, să extragem conţinutul arhivei pachete. jar. Pentru aceasta, 
executaţi comanda următoare din directorul c : |javawork, într-o fereastră de 
comandă: 


jar xf pachete.jar 


Rezultatul execuţiei acestei comenzi sunt cele două directoare conţinute în 
arhivă, împreună cu subdirectoarele şi fişierele pe care le conţin. Aceste direc- 
toare sunt com, unde se află clasele aplicaţiei de test, şi META-INF, unde se 
găseşte fişierul MANIFEST .MF. După cum se observă, toate fişierele şi direc- 
toarele conţinute au fost extrase, iar fişierul pachete. jar a rămas intact. 

Pentru a extrage doar anumite fişiere din arhiva jar, trebuie să le specificaţi 
ca argument. Ca exemplu, executaţi comanda: 


jar xf pachete.jar com/test/posesori/Firma.class 


Această comandă crează ierarhia de directoare com/test/posesori, 
în cazul în care nu există în directorul curent, şi apoi crează o copie a fişierului 
Firma.class în directorul posesori. 


C.3.5  Fişierul manifest al unei arhive jar 


Fişierul manifest este un fişier special al unei arhive jar, care conţine in- 
formaţii despre fişierele arhivate. Implicit, fişierul are numele MANIFEST .MF. 

Crearea unei arhive jar presupune, implicit, crearea unui fişier manifest, 
asociat cu respectiva arhivă. Fiecare arhivă jar are un singur fişier manifest, 
care este automat creat în directorul META-INF al arhivei. Numele fişieru- 
lui manifest şi al directorului în care se află acesta, nu pot fi modificate, deci 
întotdeauna fişierul manifest are locaţia META- INF /MANIFEST .MF. 
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Informaţiile conţinute într-un fişier manifest sunt de tipul "cheie: valoare”. 
De exemplu, fişierul manifest al arhivei pachete. jar are următorul conţinut: 


Manifest-Version: 1.0 
Created-By: 1.4.0 (Sun Microsystems Inc.) 


Fişierul manifest conţine două informaţii despre arhiva pachete. jar: 
versiunea fişierului manifest (specificată de cheia Manifest-Version) şi 
numele platformei Java care a creat fişierul manifest respectiv (specificat de 
cheia Created-By). 

Acesta este formatul standard al unui fişier manifest asociat unei arhive 
jar. Informaţiile pe care le oferă diferă însă de la o arhivă la alta, în funcţie 
de scopul arhivei. Cu alte cuvinte, pe lângă acestea mai pot apare şi altele, 
care vor fi prezentate în continuare. Dacă rolul pe care îl are arhiva jar este 
doar cel standard al unei arhive, cum ar fi compresia datelor, nu trebuie să vă 
faceţi probleme în legătură cu fişierul manifest, pentru că fişierul manifest nu 
are nici un rol în astfel de situaţii. Dacă, însă, doriţi ca arhiva jar să prezin- 
te funcţionalităţi speciale (avansate), atunci va trebui să modificaţi conţinutul 
fişierului manifest, dar pentru aceasta mai întâi va trebui să cunoaşteţi ce tre- 
buie modificat în fişierul manifest şi, după aceea, cum trebuie să-l modificaţi. 

Pentru ca o aplicaţie "împachetată" într-un fişier jar, să poată fi executată 
folosind acest format, este necesară specificarea "punctului de intrare" al apli- 
caţiei, adică numele clasei în care se află metoda main (), care este apelată în 
cazul în care aplicaţia nu este arhivată într-un fişier jar. 

Specificarea numelui clasei respective se realizează utilizând cheia Mai n-- 
Class. Pentru aplicaţia noastră de test, informaţia arată astfel: 


Main-Class: com.test.ExempluPachete 


Dacă aplicaţia dumneavoastră utilizează clase disponibile în alte arhive jar, 
atunci trebuie specificat acest lucru prin intermediul cheii Class-Path. Deşi 
în cazul aplicaţiei noastre nu se folosesc clase din alte arhive jar, iată un ex- 
emplu de prezentare a acestei informaţii: 


Class-Path: test2.jar app/test3.jar 


Pentru a reţine informaţii referitoare la versiunea pachetelor conţinute într- 
o arhivă jar, se pot utiliza chei speciale. Iată un exemplu, adaptat la datele 
existente în aplicaţia noastră: 


Name: com/test/masini 
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Specification-Title: "Clase de masini” 
Specification-Version: "1.0" 
Specification-Vendor: "X Software" 
Implementation-Title: "com.test.masini" 
Implementation-Version: "versiune de test 0.12" 
Implementation-Vendor: "X Software" 


Un astfel de set de informații poate fi prezentat pentru fiecare pachet al 
aplicației. 


C.3.6 Modificarea fişierului manifest al unei arhive jar 


Modificarea fişierului manifest al unei arhive jar se realizează prin inter- 
mediul opțiunii m pe care o oferă utilitarul jar. Opțiunea m permite adăgarea 
în fişierul manifest a informaţiilor dorite, în timpul operației de creare a arhivei 
jar. 

Formatul standard al comenzii este: 


jar cfm nume_fisier_manifest nume_fisier_jar 
nume_fisiere 


Dat fiind faptul că prin această comandă se crează un fişier jar, opțiunile 
cf şi argumentele nume_fisier_jar şi nume_fisiere au aceeaşi sem- 
nificație cu cea descrisă la secțiunea de creare a unui fişier jar. Prin urmare, 
singurele lucruri care mai trebuie precizate sunt: 


e opțiunea m specifică faptul că se vor adăuga anumite informaţii în fişierul 
manifest creat automat la crearea unei arhive jar; 


e argumentulnume_fisier_manifest reprezintă numele fişierului din 
care vor fi preluate informaţiile care vor fi adăugate în fişierul manifest. 


Ca exemplu, vom recrea arhiva pachete. jar, adăugând fişierului manifest 
câteva informaţii cu caracter special. Astfel, în directorul curent, c : \J avawork, 
se crează un fişier cu numele info .txt, având următorul conținut: 


Main-Class: com.test.ExempluPachete 


Name: com/test/masini 
Specification-Title: "Clase de masini" 
Specification-Version: "1.0" 
Specification-Vendor: "CompaniaMea" 
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Implementation-Title: "com.test.masini" 
Implementation-Version: "versiune de test 0.12" 
Implementation-Vendor: "X Software" 


După ce fişierul este salvat, se execută comanda: 
jar cmf info.txt pachete.jar com 


Rezultatul execuţiei acestei comenzi este arhiva pachete. jar. Pentru a 
vedea modificările efectuate în fişierul manifest, extrageţi acest fişier din arhivă. 
Fişierul ar trebui să arate astfel: 


Manifest-Version: 1.0 
Main-Class: com.test.ExempluPachete 
Created-By: 1.4.0 (Sun Microsystems Inc.) 


Name: com/test/masini 

Specification-Title: "Clase de masini” 
Specification-Vendor: "X Software” 
Implementation-Vendor: "X Software" 
Specification-Version: "1.0" 
Implementation-Version: "versiune de test 0.12" 
Implementation-Title: "com.test.masini" 


Se observă că noul fişier manifest este o combinaţie între fişierul standard 
creat de utilitarul jar şi fişierul info.txt. 


C.3.7 Modificarea conţinutului unui fişier . jar 


Conţinutul unui fişier jar poate fi modificat folosind opţiunea u a utilitaru- 
lui jar. Prin modificarea conţinutului unui fişier jar se poate înţelege atât 
modificarea fişierului manifest asociat arhivei jar, cât şi adăugarea unor noi 
fişiere în arhiva jar. 

Forma standard a comenzii este: 


jar uf nume_fisier_jar nume_ fisiere 
Opțiunile şi argumentele utilizate au următoarea semnificaţie: 


e opţiunea u semnifică faptul că arhiva jar va fi modificată; 


e opţiunea f specifică faptul că numele fişierului care va fi modificat este 
precizat în linie de comandă; 
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e argumentul nume_fisier_jar reprezintă numele fişierului care este 
modificat (actualizat); 


e argumentul nume_fisiere reprezintă o listă de fişiere ce vor fi adău- 
gate în arhivă. 


Dacă se utilizează opţiunea m (asemănător cu secţiunea anterioară, de modifi- 
care a fişierului manifest), atunci se poate modifica fişierul manifest al arhivei 
jar, concomitent cu adăugarea unor noi fişiere în arhiva jar. 

Dacă, de exemplu, se doreşte adăugarea în arhiva pachete. jar aunui 
nou fişier new. gif, aflat în directorul curent, atunci se execută comanda: 


jar uf pachete.jar new.gif 


De asemenea, se poate modifica fişierul manifest al arhivei pachete. jar, 
prin execuţia următoarei comenzi (fişierul info.txt este cel definit la secţi- 
unea anterioară): 


jar umf info.txt pachete.jar 


LĂ Lai 


C.3.8  Rularea aplicaţiilor Java '"'împachetate" într-o arhivă 
jar 
Aplicațiile care sunt arhivate în cadrul unui fişier jar pot fi rulate folosind 
comanda: 


java -jar nume_fisier_jar 


Opţiunea -jar specifică faptul că aplicația ce va fi rulată este conținută într- 
o arhivă jar. Această comandă poate fi utilizată doar dacă în fişierul manifest 
al arhivei jar este specificat "punctul de intrare" al aplicației, prin intermediul 
cheii Main-Class. În consecință, pentru a putea rula o aplicație conținută 
într-o arhivă jar, trebuie mai întâi să modificaţi fişierul manifest pentru a in- 
troduce informația cerută. 

În exemplul nostru, odată ce valoarea cheii Main-Class este specificată, 
se poate rula aplicația utilizând comanda: 


java -jar pachete.jar 


Rezultatul execuției acestei comenzi este următorul: 
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Tipurile de masini Dacia detinute de Mircea Ionescu: 
1300 

Tipurile de masini Ferrari detinute de Sun: 

E50 


În concluzie, secțiunea destinată arhivelor jar prezintă modalitatea de a 
realiza operații de bază cu arhive jar, precum şi modalitatea de a rula aplicații 
conținute în cadrul unei astfel de arhive, înfăţişând aceste caracteristici într- 
un mod simplu, la obiect, plin de exemple elocvente, pentru ca programatorul 
să poată surprinde facilitățile puternice pe care le oferă aceste arhive specifice 
platformei Java. 
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Colecţii de resurse 


Pentru un bărbat curajos, fiecare 
ţară reprezintă o patrie. 


Proverb grecesc 


Lumea în care trăim este mică şi tinde să devină din ce în ce mai mică pe 
zi ce trece. În mare măsură, acesta este rezultatul implicării computerelor în vi- 
aţa noastră. Internetul a devenit în ultimii ani principalul mijloc de comunicare 
între oameni, pentru că oferă o modalitate foarte simplă şi rapidă de comuni- 
care. Emailul sau navigarea pe Internet nu mai reprezintă o necunoscută pentru 
majoritatea dintre noi. Practic, putem spune că trăim într-un imens sat, în care 
fiecare poate comunica simplu şi rapid cu ceilalţi. Efectul globalizării se simte 
şi în industria IT, unde programatorii trebuie să considere ca piaţă de desfacere 
întreaga planetă. Ei sunt nevoiţi să dezvolte aplicaţii care pot fi utilizate din 
Los Angeles până la Paris, fără ca acest lucru să implice un efort prea mare de 
programare. Cu alte cuvinte, sarcina lor este de a crea aplicaţii internaționali- 
zate. Din acest punct de vedere, programatorii Java pot să fie liniștiți. J2SDK 
oferă o întreagă ierarhie de clase care permite adaptarea unei aplicaţii de la o 
limbă/cultură la alta, cu un efort minim de implementare. În Java, procesul este 
chiar mai simplu decât pare. 


D.1 Timpul, numerele şi datele calendaristice 


Este foarte bine cunoscut faptul că, datorită diverselor popoare şi culturi 
existente pe planeta noastră, nu există un standard acceptat la scară planetară 
pentru afişarea numerelor, a datelor calendaristice sau a timpului. 
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Să luăm ca exemplu următoarea dată: 5/3/02. Pentru cei ce locuiesc în 
Statele Unite, această dată reprezintă data de 3 mai 2002, în timp ce pentru cei 
ce locuiesc în Europa, aceasta reprezintă 5 martie 2002. După cum se poate 
observa, modul în care componentele unei date (zi, lună, an) sunt combinate şi 
diferă de la o ţară la alta. În Statele Unite, formatul este în stilul lună/zi/an, în 
timp ce în majoritatea ţărilor din Europa formatul este zi/lună/an. Poate că nu 
este o diferenţă mare, dar nu trebuie subestimată importanţa ei pentru utilizatorii 
aplicaţiilor. 

Formatele de date sunt poate cele mai simple. Ce se poate spune despre 
formatele de reprezentare a timpului sau cele de reprezentare a sumelor de bani 
(formate monetare) sau a numerelor? Răspunsul va fi descoperit pe parcursul 
acestei secţiuni a anexei. 

Convenţiile de formate variază de la o ţară la alta, uneori semnificativ. Ex- 
istă situaţii în care aceste convenţii variază chiar şi în interiorul aceleaşi ţări. 
Iată câteva exemple: 


e Timpul 


Afişarea orelor, minutelor şi secundelor pare să fie cea mai simplă din- 
tre sarcini, dar nu este aşa. Diferențe apar de exemplu la caracterul de 
separare a orelor de minute. Unele ţări folosesc simbolul “:” (11:13 
PM), în timp ce altele (Italia etc.) folosesc simbolul “.” (23.13). De 
asemenea, cele 24 de ore ale zilei pot fi reprezentate ca jumătăţi de zi de 
câte 12 ore (primul exemplu), sau cu ore cuprinse între 0 şi 24 (al doilea 
exemplu); 


e Datele calendaristice 


Exemplele anterioare au arătat că poziţia zilei, a lunii şi a anului într-o 
reprezentare de dată calendaristică diferă de la o zonă la alta. Pe de altă 
parte, caracterul de separare diferă şi el de la “/” în Statele Unite (de 
exemplu, 5/ 3/02), la “.” în Germania (de exemplu, 03.05.02). De 
asemenea, numele zilelor şi ale lunilor diferă de la o limbă la alta; 


e Numerele 


Primul lucru care atrage atenţia în cazul numerelor este separatorul zeci- 
mal. Statele Unite folosesc simbolul “ .” (de exemplu, 3 . 55), dar alte 
țări (România etc.) preferă simbolul “, ” (de exemplu 3, 55). Pentru 
a îmbunătăţi citirea numerelor mai mari, cifrele sunt grupate de obicei, 
obținându-se mii, milioane, miliarde etc. În Statele Unite acest sim- 
bol este “,” (de exemplu, 3, 403.45), iar în alte ţări (România etc.) 
acest simbol este “.” (de exemplu, 3.403, 45). Sumele de bani sunt 
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reprezentate de asemenea diferit. Cei mai mulţi sunt familiarizați cu sem- 
nul $ folosit de Statele Unite şi alte ţări (de exemplu, $3, 400.00), dar 
există numeroase alte alternative. 


De la lansarea ei, Java a fost catalogată drept soluţia dezvoltării de aplicaţii in- 
ternaţionalizate. Dar până la apariţia JDK 1.1, suportul pentru internaţionalizare 
a fost redus. Începând însă cu versiunea anterior amintită, Sun a inclus în dis- 
tribuţia JDK pachetul java.text care conţine clasele şi interfețele pentru 
manevrarea textului în formate locale specifice diverselor culturi. 

Înainte de a prezenta soluţia Java pentru tratarea situaţiilor anterioare, este 
cazul să prezentăm noţiunea de localizare (engl. locale) şi clasa Java asociată, 
Locale. 

O localizare poate desemna o regiune culturală, politică sau geografică. De 
exemplu, poate fi considerată regiunea din care provine un grup de persoane 
care vorbesc aceeaşi limbă. Din acest motiv, limba vorbită de aceste persoane 
este importantă pentru o localizare. Naţionalitatea de asemenea, pentru că, de 
exemplu, deşi americanii şi britanicii vorbesc aceeaşi limbă, ei au totuşi iden- 
tităţi culturale diferite. 

În Java, localizarea este reprezentată printr-o instanţă a clasei Locale din 
pachetul java.util. O instanţă a clasei Locale poate fi creată pentru orice 
limbă şi orice ţară. Localizarea se crează pe baza numelor limbii şi a ţării pentru 
care se realizează respectiva localizare. Ambele nume reprezintă de fapt abre- 
vieri în conformitate cu standardele ISO. Codurile asociate limbilor reprezintă 
două litere mici ale alfabetului, ca de exemplu "en" pentru engleză, în timp ce 
codurile asociate ţărilor reprezintă două litere majuscule, ca de exemplu "US" 
pentru Statele Unite. 

Dacă doriţi să vedeţi lista completă a acestor abrevieri, vizitaţi următoarele 
Site-uri: 


e nttp://www.ics.uci.edu/pub/ietf/http/related/ 
i1s0639.txt, pentru codurile asociate limbilor; 


e http://www.chemie.fu-berlin.de/diverse/doc/ 
ISO_3166 .html, pentru codurile asociate ţărilor. 


Există însă anumite valori predefinite pentru unele ţări (Canada, Franţa, Germa- 
nia, Italia, Statele Unite etc.) sau pentru unele limbi (engleză, franceză, italiană 
etc.), identificabile în cadrul clasei Locale prin intermediul atributelor statice 
ale clasei (CANADA, FRANCE pentru ţări sau, respectiv, ENGLISH, FRENCH, 
pentru limbi). 
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În general, operaţiile care necesită internaţionalizarea (formatarea unei date 
calendaristice, de exemplu), folosesc ca argument o instanţă a clasei Locale. 
Dacă acest lucru nu este specificat, atunci se foloseşte localizarea implicită. 

Exemplul 1: 


1 //foloseste localizarea implicita in 

2 // operatii de _ internationalizare 

3Locale loc = Locale. getDefault(); 

4 

5//afiseaza limba asociata localizarii curente 
6 System. out. printin (loc. getDisplayLanguage ()); 


5 
s //afiseaza tara asociata localizarii curente 
9 System . out. println (loc. getDisplayCountry ()); 


Dacă, de exemplu, localizarea implicită este reprezentată de limba engleză 
şi Statele Unite, atunci secvența de cod anterioară afişează: 


English 
United States 


Exemplul 2: 


// creaza o localizare pentru Romania si limba romana 

// primul parametru este codul ISO pentru limba romana 
//al doilea parametru este codul ISO pentru numele tarii 
Locale nl = new Locale("ro", "RO"); 


O localizare poate fi făcută implicită pentru o instanță a JVM-ului prin 
metoda setDefault (), ca în exemplul următor, în care nl este variabila 
din exemplul precedent): 


//localizarea romana este setata ca fiind implicita 
Locale . setDefault(nl); 


sau 


//localizarea germana este setata ca fiind implicita 
Locale . setDefault (Locale .GERMAN); 


Dacă o localizare nu este făcută implicită prin apelul metodei setDefault, 
atunci localizarea implicită este reprezentată de limba în care a fost instalată 
distribuţia J2SDK. 

Timpul poate fi formatat utilizând clasa DateFormat. De asemenea, cu 
ajutorul acestei clase se pot formata şi datele calendaristice sau se pot cons- 
trui timpul şi datele calendaristice într-o formă independentă de limbă. Clasa 
oferă numeroase metode statice pentru obţinerea timpului/datelor calendaris- 
tice, pe baza localizării implicite sau a uneia specificate explicit, şi pe baza unui 
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număr de stiluri de formatare. Acestea includ opţiunile FULL, LONG, MEDIUM, 
SHORT. În general, 


e opțiunea SHORT reprezintă data/timpul în forma: 10.12.02 sau 3:30 PM; 
e opţiunea MEDIUM formatează data/timpul astfel: Dec 12, 2002; 


e opţiunea LONG formatează data/timpul astfel: December 12, 2002 sau 
3:30:55 PM; 


e opţiunea FULL formatează data/timpul astfel: Thursday, December 12, 
2002 AD sau 3:30:55 PM PST. 


Pentru a putea formata timpul în localizarea curentă, este necesară obţinerea 
unei instanţe, folosind metoda get Timelnstance () aclasei DateFormat. 
Formatarea propriu-zisă se realizează cu metoda format (), ca în exemplul: 

1 //afisarea timpului forma scurta in localizarea implicita 

2 DateFormat tf = DateFormat. getTimelnstance (DateFormat .SHORT); 

3 System . out. println (tf. format(new Date ())); 


4 
5s//afisarea timpului forma scurta in localizare italiana 
6 tf = DateFormat. getTimelnstance (DateFormat .SHORT, 

7 Locale .ITALY); 


s System .out.println(tf.format(new Date ())); 


Rezultatul execuţiei acestei secvenţe de cod arată astfel: 


11:39 AM 
11.39 


Prima valoare afişată reprezintă timpul pentru localizarea implicită (engleză 
în cazul nostru), iar cea de a doua reprezintă timpul în localizare italiană. Dife- 
renţa de formatare dintre cele două valori este cât se poate de clară. 

Pentru a formata data calendaristică în localizarea curentă, se folosesc me- 
todele getDatelnstance () (pentru obţinerea unei instanţe a clasei care 
permite administrarea datelor calendaristice) şi format () (pentru formatarea 
propriu-zisă), ale clasei DateFormat: 

1 //afisarea datei forma scurta in localizarea implicita 
2 DateFormat tf = DateFormat. getDatelnstance (DateFormat .SHORT); 


3 System . out. println (tf. format(new Date ())); 

4 

5s //afisarea datei forma scurta in localizare italiana 
6 tf = DateFormat. getDatelnstance (DateFormat .SHORT, 

7 Locale .ITALY); 


s System . out. println (tf.format(new Date ())); 
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9 
0 // afisarea datei forma scurta in localizare germana 
n tf = DateFormat. getDatelnstance (DateFormat .SHORT, 

12 Locale .GERMANY ); 


13 System . out. println (tf. format(new Date ())); 


Secvența afisează următoarele valori pentru 19 ianuarie 2002, corespunză- 
toare localizării implicite (engleză, în cazul nostru), localizării italiene (a doua 
variantă) şi localizării germane (a treia variantă): 


1/19/02 
19/01/02 
9-a 010Z 


Analog poate fi folosită metoda par se (), care, spre deosebire de metoda 
format (), care transformă o dată calendaristică într-un string, realizează o- 
peraţia inversă, de creare a unei date calendaristice dintr-un string. 

Numerele, procentele şi sumele de bani se formatează utilizând clasa Num- 
berFormat, într-un mod asemănător cu cele prezentate anterior. 

Aşadar, pentru a formata un număr într-o localizare la alegere se utilizează 
metodele get Instance () şi format (): 

ı //afisarea numerelor in localizarea implicita 
2 NumberFormat nf = NumberFormat. getlnstance (); 
3 System. out. println (nf. format(12500.5)); 

4 

5//afisarea numerelor in localizare germana 


6 nf = NumberFormat . getInstance (Locale .GERMANY); 
7 System. out. println (nf. format(12500.5)); 


Rezultatul este: 


127300435 
12330073 


Prima valoare afişată este pentru localizarea implicită (engleză în cazul nos- 
tru), în timp ce cea de a doua este pentru localizarea germană. 

Formatarea procentelor se realizează prin metodele getPercentInstan- 
ce () şi format (): 


ı //afisarea procentelor in localizarea britanica 
2 NumberFormat nf = NumberFormat. getPercentlnstance (Locale .UK); 
3 System. out. println (nf. format (0.3)); 


Rezultatul afişat în urma execuţiei acestei secvenţe este: 


30% 
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Formatarea monetară se realizează prin getCurrencyInstance () şi 
format (): 
1 //afisarea unei sume de bani in localizarea implicita 
2 NumberFormat nf = NumberFormat. getCurrencylnstance (); 
3 System . out. println (nf. format(8599.99)); 
4 
5//afisarea unei sume de bani in localizare italiana 
6 nf = NumberFormat. getCurrencylnstance (Locale .ITALY); 
7 System . out. println (tf. format(8599.99); 


Rezultatul poate considerat un pic surprinzător: 


3.3... e i 
Es -840.0.0 


Surpriza o constituie faptul că pentru lira italiană nu se consideră subdivi- 
ziuni, sumele fiind rotunjite pentru a se obține valori întregi, acest lucru da- 
torându-se faptului că moneda italiană este "slabă" în comparație cu celelalte 
monede. Ca şi în cazul datelor calendaristice, se poate utiliza metoda parse () 
pentru a realiza operațiile inverse, de transformare a stringurilor în numere. 

Probabil că sunt programatori care consideră în acest moment, că formatarea 
timpului, a datelor calendaristice şi a numerelor sunt doar detalii de afişare a 
rezultatelor şi nu au implicaţii foarte mari. Utilizatorii aplicaţiilor s-ar putea 
să nu fie de acord cu această poziţie, în special din cauza faptului că afişarea 
rezultatelor nu se face în conformitate cu aşteptările lor. De aceea, programa- 
torii trebuie să fie foarte atenţi la acest detaliu pe care, poate, până acum nu l-au 
tratat cu îndeajuns de multă seriozitate, pentru a realiza o afişare a datelor într-o 
formă cât mai "prietenoasă". 


D.2 Colecțiile de resurse în internaţionalizarea apli- 
caţiilor 


Când programatorii de la Sun au scris codul pentru cele două clase, Date- 
Format şi NumberFormat, ei au fost cei care au decis ce localizări să suporte 
(engleză, franceză, germană etc.) şi au oferit astfel modalitatea de a realiza con- 
versiile de date pentru respectivele localizări. Deoarece variațiile datelor calen- 
daristice şi ale numerelor nu sunt foarte mari, ei au putut implementa clasele 
DateFormat şi NumberFormat, în conformitate cu respectivele localizări, 
direct în biblioteca de clase (API) pe care Java o oferă. 

Din păcate, lucrurile nu au mai fost la fel de simple în cazul mesajelor de 
tip text. Ar fi fost imposibil pentru programatorii de la Sun să anticipeze toate 
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mesajele de tip text folosite în aplicaţii (existente sau viitoare) şi să ofere tradu- 
cerile necesare. Din acest motiv, au lăsat această sarcină programatorilor Java 
care realizează aplicaţii internaţionalizate. Aceasta înseamnă că programatorul 
Java este cel care decide ce localizări suportă aplicaţia, urmând ca tot el să ofere 
traducerile mesajelor text pentru fiecare localizare suportată de aplicaţia sa. Cu 
alte cuvinte, programatorul va crea o colecţie de stringuri pentru o anumită 
localizare şi le va utiliza în diverse locuri pe parcursul aplicaţiei. 

Pentru a realiza acest demers, implementatorii limbajului Java au pus la dis- 
poziţia programatorilor colecţiile de resurse (engl. resource bundles), cunoscute 
altfel şi sub numele de pachete de resurse. 


D.2.1 Un exemplu concret 


Colecţiile de resurse înglobează toate informaţiile specifice unei anumite 
localizări. După cum am văzut în paragraful 7.5 (pagina 212), fiecare resursă 
este asociată cu o cheie, care rămâne neschimbată pentru toate localizările. Va- 
loarea asociată acestei chei se schimbă însă pentru fiecare localizare în parte, 
reprezentând de fapt traducerea în respectiva limbă a informaţiei deţinute de 
resursă. 

Să considerăm următorul exemplu: dorim să realizăm o aplicaţie care afi- 
şează în diverse limbi, noţiunile de calculator, hard-disk, monitor şi tastatură. 
Deoarece aceste denumiri se vor schimba în cadrul colecţiilor de resurse, fiind 
înlocuite cu traducerile lor, trebuie să le asociem cu nişte chei care vor rămâne 
neschimbate. Presupunem că avem următoarele asocieri: 


Cheie | Valoare 
calc | calculator 
hdd | hard-disk 
mon | monitor 
tast | tastatura 


Asocierile de mai sus formează o colecție de resurse, cu patru perechi de 
tipul cheie-valoare. Pentru fiecare limbă în care dorim să traducem aceste noţi- 
uni, vom avea câte o colecţie de resurse în care cheile vor fi aceleaşi cu cele an- 
terioare, iar valorile vor reprezenta traducerile potrivite pentru fiecare noţiune. 
Vom considera că avem traducerile noţiunilor anterioare în trei limbi: engleză, 
germană şi franceză. Prin urmare, vom avea alte trei colecţii de resurse, câte 
una pentru fiecare limbă în care facem traducerea: 


e pentru limba engleză 
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Cheie | Valoare 
calc | computer 
hdd | hard disk 
mon | monitor 
tast | keyboard 


e pentru limba germană 


Cheie | Valoare 
calc | Computer 
hdd | Platte 
mon | Monitor 
tast | Tastatur 


e pentru limba franceză 


Cheie | Valoare 
calc | ordinateur 
hdd | disque dur 
mon | moniteur 
tast | clavier 


După cum se observă, faptul că aceste chei rămân neschimbate ne ajută să aso- 
ciem corect fiecare noţiune cu traducerea ei. Astfel, noţiunea calculator 
are în primul tabel asociată cheia calc, care corespunde în următoarele trei 
tabele cuvintelor computer, Computer, ordinateur, cu alte cuvinte am 
obţinut traducerea noţiunii în fiecare dintre cele trei limbi. 

Un set de colecţii de resurse formează un grup. Grupul are un nume, ales 
sugestiv de programator. Analog, fiecare colecţie de resurse din cadrul grupului 
are un nume, construit în mod unic: numele grupului, urmat de numele limbii 
în care sunt traduse resursele, de numele ţării şi de variant (variant reprezin- 
tă o subregiune a unei ţări). Ultimele două adăugări de nume sunt opţionale. 
Numele limbii şi cel al ţării sunt reprezentate prin abrevieri de două litere, în 
conformitate cu standardele ISO. De exemplu, abrevierea pentru Canada este 
"CA", iar pentru limba franceză este "fr". În majoritatea cazurilor aceste nume 
sunt evidente. 

Un alt aspect important legat de modul de construire a numelui unei colecţii 
de resurse este că fiecare nume este separat de următorul prin simbolul "_". 
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Important de reţinut este şi faptul că există o colecţie care are acelaşi nume cu 
grupul din care face parte. Aceasta este denumită colecția implicită. 

Deşi modalitatea de denumire a colecţiilor din cadrul unui grup poate părea 
dificilă, ea este de fapt destul de simplă. Pentru a verifica această afirmaţie, iată 
cum arată aceste denumiri în exemplul nostru: am denumit grupul de colecţii 
Componente, ceea ce înseamnă că numele colecţiei implicite este tot Com- 
ponente. Considerăm prima colecţie prezentată (cea în limba română) ca 
fiind implicită. Cea de a doua colecţie, cea cu traducerile în limba engleză se 
numeşte, conform regulii de denumire prezentată anterior, Componente_en. 
Analog, celelalte două colecţii se numesc Componente_de şi Componen- 
Ce Tr, 

În continuare vom vedea cum implementează Java colecțiile de resurse sub 
forma unor subclase ale clasei abstracte ResourceBundle: 


e ListResourceBundle 
e PropertyResourceBundle 


Vom analiza fiecare dintre cele două modalități mai detaliat în cele ce urmează. 


D.2.2 Implementarea colecțiilor prin Li stResourceBundle 


ListResourceBundle conține resursele în cadrul unor clase Java stan- 
dard, a căror denumire este dată de numele fiecărei colecții de resurse, aşa cum 
a fost el stabilit prin aplicarea regulii de denumire. Aceste clase trebuie să 
suprascrie metoda getContents () şi să ofere un şir care conține perechile 
de resurse (cheie, valoare) de tipul String. Pentru exemplul nostru, lucrurile 
stau astfel: 


e în primul rând avem colecția implicită, implementată în modul următor 
(în fişierul Componente. java): 


ı import java.util.x; 
2 
3 public class Componente extends ListResourceBundle 


al 


5 static final Object [][] contents = { 

6 "comp", "calculator”), 
7 {"hdd", "hard—disk"], 

8 "mon", "monitor”), 

9 {"tast", "tastatura "] 
10 }; 

ll 

12 public Object [][] getContents () 
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13 í 
14 return contents; 
15 } 


apoi, avem implementarea colecției de resurse pentru limba engleză (în 
fişierul Componente_en. java): 


ı import java.util.x; 
2 
3 public class Componente_en extends ListResourceBundle 


4 

{ 

5 static final Object [][] contents = { 

6 { "comp", "computer" }, 
7 {"hdd", "hard disk"}, 
8 "mon", "monitor" }, 
9 {"tast", "keyboard" } 
10 js 

11 

12 public Object [][] getContents () 

13 { 

14 return contents; 

15 } 


mai apoi, implementarea colecției de resurse pentru limba germană (în 
fişierul Componente_de.java): 


ı import java.util.x; 
2 
3 public class Componente_de extends ListResourceBundle 


4 

{ 

5 static final Object [][] contents = |] 

6 "comp", "Computer" ], 
7 {"hdd", "Platte”), 

8 "mon", "Monitor" }, 
9 {"tast", "Tastatur"} 
10 F 

11 

12 public Object [][] getContents () 

13 | 

14 return contents; 


15 ) 


în final, implementarea colecţiei de resurse pentru limba franceză (în 
fişierul Componente_fr.java): 
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import java. util.x; 
2 
3 public class Componente_fr extends ListResourceBundle 


al 


5 static final Object [][] contents = { 

6 "comp", "ordinateur'), 
7 "hdd", "disque dur”), 
8 "mon", "moniteur" }, 

9 {"tast", "clavier"} 

10 }; 

11 

12 public Object [][] getContents () 


13 { 


14 return contents; 


15 } 


Odată clasele implementate, ele pot fi utilizate cu succes, conform exemplului 
din paragraful D.2.4. 

Până atunci, iată câteva detalii importante legate de implementarea colecţi- 
ilor de resurse prin această metodă. În primul rând, clasele au exact acelaşi 
nume cu cel stabilit la definirea colecțiilor: Componente, Componente_en, 
Componente_de, Componente_fr. În al doilea rând, informaţia de aso- 
ciere a cheilor cu valorile corespunzatoare este conținută în interiorul claselor. 
Fiecare pereche cheie/valoare reprezintă un element al şirului content s. Din 
cauza faptului că datele sunt stocate în interiorul unor clase, apare un dezavan- 
taj destul de important: clasele trebuie recompilate pentru orice modificare a 
valorilor. Este motivul pentru care această variantă este mai puţin utilizată de 
programatori. 

O alternativă a acestei clase este clasa PropertyResourceBundle, 
care reţine resursele în fişiere de proprietăţi. 


D.2.3 Implementarea colecţiilor prin PropertyResourceBundle 


Clasa PropertyResourceBundle foloseşte un tip special de fişiere 
pentru a stoca informaţiile de mapare a cheilor şi a valorilor. Aceste fişiere sunt 
de fapt simple fişiere text, cu extensia .properties. Numele fiecărui fişier 
de acest tip este dat tot de regula de denumire a colecţiilor de resurse. Aşadar, 
în exemplul nostru sunt patru fişiere de proprietăţi cu următoarele denumiri: 


e Componente.properties 


e Componente_en.properties 
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e Componente _de.properties 


e Componente_fr.properties 


Formatul special al fişierelor de proprietăţi apare datorită faptului că perechile 
cheie/valoare sunt stocate pe câte o linie separată. Fiecare linie este formată din 
cheie, urmată de semnul "=", iar în final este adăugată valoarea asociată cheii. 

Pentru exemplul nostru, cele patru fişiere .properties au următorul 
conţinut: 


e fişierul Componente.properties: 


comp=calculator 
hdd=hard-disk 
mon=monitor 
tast=tastatura 


e fişierul Componente_en.properties: 


comp=computer 
hdd=hard disk 
mon=monitor 

tast=keyboard 


e fişierul Componente_de.properties: 


comp=Computer 
hdd=Platte 
mon=Monitor 
tast=Tastatur 


e fişierul Componente_fr.properties: 


comp=ordinateur 
hdd=disque dur 
mon=moniteur 
tast=clavier 


În acest moment, fişierele de proprietăţi sunt gata pentru a fi utilizate. 
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D.2.4 Utilizarea colecţiilor de resurse 


Indiferent că aţi optat pentru prima metodă de implementare a colecţiilor de 
resurse (utilizând clasa ListResourceBundle), sau pentru cea de a doua 
(prin intermediul clasei PropertyResourceBundle), utilizarea colecţiilor 
de resurse se realizează în acelaşi mod. Aşadar, dacă doriţi să treceţi de la 
o metodă la cealaltă, nu trebuie să modificaţi nimic în modul de utilizare a 
colecţiilor de resurse. 

Această secţiune va arăta cât de elegant se face traducerea noţiunilor alese 
dintr-o limbă în alta. Pentru aceasta, vom considera următorul program de test 
(fişierul Uti1RB. java): 

ı import java.util.x; 


2 


3 public class UtilRB 
af 


5 public static void main(String [|] args) 

6 { 

7 try 

8 ( 

9 Locale . setDefault(new Locale("ro", '"RO')); 

10 ResourceBundle rb = ResourceBundle. getBundle( 
11 "Componente", Locale. getDefault ()); 
12 

13 String s = rb.getString("'comp"); 

14 System . out. println (s); 

15 

16 s = rb. getString("tast"); 

17 System . out. println (s); 

18 } 

19 catch (Exception e) 

20 { 

21 System . out. println ("EXCEPTION: " + 

22 e. getMessage ()); 


Prezentat pe scurt, programul anterior setează localizarea implicită ca fi- 
ind cea română, iar apoi utilizează colecţia de resurse ataşată localizării im- 
plicite (cu alte cuvinte, colecţia de resurse implicită, Componente), pentru a 
descoperi valorile ataşate celor două chei "comp" şi "tast", valori pe care 
le afişează. Rezultatul execuţiei acestui program este: 


calculator 
tastatura 


Analog se pot afişa valorile celorlalte chei. 
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Pentru a vedea adaptabilitatea foarte bună a colecţiilor de resurse la modifi- 
carea limbilor folosite, realizaţi în programul sursă anterior modificările nece- 
sare pentru ca programul să arate astfel: 


ı İmport java.util.x; 
2 


3 public class UtilRB 
al 


5 public static void main(String [] args) 

6 { 

7 try 

8 { 

9 Locale . setDefault(new Locale("ro", "RO" )); 

10 

11 ResourceBundle rb = ResourceBundle .getBundle( 
12 "Componente", Locale . ENGLISH ); 
13 

14 String s = rb. getString ("comp"); 

15 System . out. printlin (s); 

16 

17 s = rb. getString("tast"); 

18 System . out. printlin (s); 

19 

20 catch (Exception e) 

21 { 

22 System . out. println ( "EXCEPTION: " + 

23 e. getMessage ()); 


Modificarea constă în faptul că s-a schimbat localizarea, adică limba curentă 
în care se fac afişările de date este cea engleză. Dat fiind faptul că localizarea 
curentă este cea engleză, la rularea programului, Java va prelua valorile cheilor 
"comp" şi "tast" din colecţia de resurse asociată limbii engleze, adică din 
colecţia Componente_en. În urma execuţiei, vor fi afişate rezultatele: 


computer 
keyboard 


Analog se poate obţine traducerea noţiunilor în celelalte două limbi pe care 
le-am ales: germană şi franceză. Pentru a realiza acest demers, trebuie doar să 
înlocuiţi Locale.ENGLISH în programul anterior cu Locale.GERMAN şi 
mai apoi cu Locale.FRENCH. 

Un lucru important care trebuie amintit este legat de modul în care Java 
identifică pachetul de resurse pentru o anumită localizare. Colecţia este căutată 
în cadrul grupului din care face parte, conform paşilor algoritmului următor, 
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căutarea încheindu-se în momentul în care este găsită colecţia căutată sau s-a 
ajuns la colecţia implicită. 


1. bundleName_localeLanguage_localeCountry_locale Variant 

2. bundleName_localeLanguage_localeCountry 

3. bundleName_localeLanguage 

4. bundleName_defaultLanguage_defaultCountry_default Variant 
5. bundleName_defaultLanguage_defaultCountry 

6. bundleName_defaultl Language 


7. bundleName 


bundleName reprezintă numele grupului, iar localeLanguage, locale- 
Country şi localeVariant se referă la limba, ţara şi regiunea localizării 
specificate, în timp ce defaultLanguage,defaultCountry şi default 
Variant se referă la localizarea implicită. 

Pentru a înţelege mai bine acest algoritm de căutare a colecţiilor de resurse, 
vom arăta cum se realizează căutarea în exemplul nostru. Mai întâi să iden- 
uificăm numele din algoritm: bundleName este în exemplul nostru Compo- 
nente, localeLanguage este fie en (engleza), fie de (germana), fie fr 
(franceza), în timp ce localeCountry şi localeVvariant lipsesc. Pe de 
altă parte, defaultLanguage este ro (româna), în timp ce defaultCoun- 
try şi defaultVariant lipsesc de asemenea. 

Dacă, de exemplu, dorim să căutăm colecţia de resurse pentru limba ger- 
mană, trebuie să căutăm colecţia cu numele Componente_de, cu alte cuvinte 
bundleName ia valoarea Componente, iar localeLanguage ia valoarea 
de. Pentru că nu avem în această situaţie localeCountry sau localeVva- 
riant, algoritmul va fi executat până la pasul 3, când se opreşte pentru că a 
găsit colecţia cu numele Componente_de. 

Într-un mod asemănător, dacă dorim să căutăm colecţia de resurse pen- 
tru limba franceză vorbită în Canada (new Locale("fr", "CA")), Java 
va căuta colecţia cu numele Componente_fr_CA. Executând paşii algorit- 
mului anterior, ne vom opri la pasul 3, pentru că nu există o colecţie numită 
Componente_fr_CA (şi din acest motiv nu ne putem opri la pasul 2), dar 
există una numită Componente_fr. Aşadar, în această situaţie vom avea tra- 
ducerile din limba franceză standard, şi nu traducerile pentru dialectul de limbă 
franceză vorbit în Canada. 
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Forţând un pic nota, dacă dorim să căutăm colecţia de resurse pentru limba 
italiană (Locale. ITALIAN), Java caută colecţia de resurse cu numele Com- 
ponente_it, dar cum nu avem nici o componentă cu nume asemănător, 
căutarea se va încheia la pasul 7, la colecția implicită Componente, tradu- 
cerile fiind preluate din această colecţie. Prin urmare, dacă nu avem o colecţie 
asociată unei localizări specificate, traducerile vor fi oferite din colecţia impli- 
cită. 

Folosind tehnicile prezentate în primele două secţiuni ale acestei anexe, se 
pot construi aplicaţii simple care afişează utilizatorului date în orice localizare. 
Datele pot fi valori ale timpului, date calendaristice, numere sau simple mesaje 
statice, cum ar fi cele prezentate anterior. Dacă dorim să folosim mesaje di- 
namice (de genul: "x fişiere au fost şterse"), lucrurile se modifică 
destul de mult. Secţiunea următoare arată cum trebuie tratate mesajele de acest 


tip. 


D.3  Internaţionalizarea mesajelor dinamice 


Din perspectiva programatorului care rescrie aplicații într-o altă limbă, cu- 
vintele sunt cea mai simplă parte ce trebuie implementată. De exemplu, când 
se traduc cuvintele din engleză în germană, "Yes" devine "Ja", "No" devine 
"Nein" şi aşa mai departe. Chiar şi frazele simple, de tipul "Do you want 
to save the modifications?", pot fi înlocuite în întregime cu tradu- 
cerile potrivite. Dacă traducerile s-ar rezuma doar la exemple simple, de tipul 
celor menţionate anterior, atunci nu ar fi probleme. Dar ce facem dacă suntem 
nevoiţi să traducem un mesaj de tipul: "You copied 2 files"? Spre de- 
osebire de mesajele anterioare, acesta este un mesaj dinamic, conţine informaţii 
care se modifică în funcţie de alte operaţii. 

O metodă de rezolvare ar putea fi împărţirea mesajului în mai multe părţi, în 
aşa fel încât partea dinamică a mesajului să fie despărțită de cea statică. Cu alte 
cuvinte să împărţim mesajul în trei părţi: "You copied", "2" şi "files". 
În acest fel, partea dinamică a mesajului ("2") este separată de cea statică. 
Apoi, ar urma ca cele două părți statice să fie preluate din colecţii de resurse, 
unde ar fi traduse separat. Practic, codul ar fi asemănător cu: 


1 ResourceBundle rb = ResourceBundle. getBundle("Strings"); 
2 String str = rb.getString(" first") + nFiles + 
3 rb. getString("second"); 


unde "first" şi "second" ar fi cele cheile asociate celor două părţi 
statice ale mesajului, iar nFiles ar fi numărul de fişiere ce va fi copiat. 
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Din păcate, abordarea precedentă nu este universal valabilă, deoarece este 
posibil ca în alte limbi ordinea cuvintelor să nu mai fie aceeaşi. Deşi noi am 
considerat că elementele care compun textul au o anumită ordine, există limbi 
în care această ordine nu poate fi respectată. De exemplu, în limba germană 
verbele se pun la finalul propoziției. 

Din fericire, există o soluţie pentru această problemă. Trebuie să creăm un 
şablon corect din punct de vedere sintactic pentru fiecare localizare, iar apoi 
la executarea aplicaţiei şablonul este combinat cu partea dinamică a mesajului 
(altfel spus, cu parametrii). Abilitatea de a combina şablonul cu parametrii este 
oferit în Java prin intermediul clasei Messagefrormat. 

Primul pas care trebuie realizat este crearea câte unui şablon pentru fiecare 
localizare suportată de aplicaţie. Şablonul presupune înlocuirea părţilor dina- 
mice ale mesajului, cu parametrii, ca în exemplul: 


"You copied 2 files" --> "You copied (0) files" 


În cazul nostru, singura parte dinamică a mesajului este "2" şi a fost în- 
locuită cu parametrul "(0)". Dacă ar fi existat mai multe părţi dinamice în 
cadrul mesajului, parametrii ar fi fost (1), (2) etc. 

Considerăm şablonul anterior ca fiind asociat localizării implicite (în cazul 
nostru, localizarea engleză). De asemenea, considerăm şi şablonul pentru lo- 
calizarea română: 


"Ati copiat (0) fisiere" 


La executarea aplicaţiei, parametrul {0 } este înlocuit în cadrul şablonului, 
cu numărul de fişiere copiate, aşa cum a fost el calculat în cadrul aplicaţiei. 

Cele două şabloane, câte unul pentru fiecare dintre cele două localizări, vor 
fi preluate din colecţii de resurse şi folosite pentru a crea mesajele dinamice. 
Considerăm că numele grupului de colecţii este "Messages", iar cheia aso- 
ciată şablonului este "msg". 

Colecţia de resurse implicită este următoarea (Messages .properties): 


msg=You copied (0) files 


Pe de altă parte, colecţia de resurse pentru limba română arată astfel (fişierul 
Messages_ro.properties): 


msg=Ati copiat {0} fisiere 


Pentru localizarea implicită, secvenţa de cod arată astfel: 
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1 ResourceBundle rb = ResourceBundle. getBundle("Messages"); 
2 

3 MessageFormat mf = new MessageFormat(rb. getString("msg")); 
4 Object [] args = (new Integer(2)); 

5 

6 System . out. println (mf. format(args ); 


La execuţia codului va fi preluat din colecţia implicită şablonul "You co- 
pied (0) files". Prin apelului metodei format (), şablonul este com- 
binat cu valorile aflate în variabila args. Practic, parametrii şablonului sunt în- 
locuiti cu valorile de pe poziţiile corespunzătoare din şirul args. În cazul nos- 
tru, parametrul {0 ) este înlocuit cu args [0], adică cu elementul 2, obținându-— 
se mesajul formatat "You copied 2 files". 

Pentru obţinerea traducerii acestui mesaj în limba română, modificaţi prima 
linie a secvenței de cod anterioare, astfel încât să fie de forma: 


ResourceBundle rb = ResourceBundle. getBundle("Messages", 
new Locale("ro", "RO')); 


Analog celor prezentate anterior, se va obține un mesaj de forma "Ati co- 
piat 2 fisiere". 

Exemplele anterioare folosesc cele mai simple forme de parametri în cadrul 
unui şablon. Java oferă posibilitatea de a realiza formatări mult mai complexe. 


Un parametru este format de fapt din trei câmpuri separate prin simbolul 
Li! me 


LA 
e Primul câmp reprezintă un număr, care indică poziţia din cadrul şirului 
de obiecte, a obiectului cu care va fi înlocuit parametrul la formatare. De 
exemplu, parametrul O indică faptul că va fi înlocuit cu elementul de pe 
poziţia O din şir, parametrul 1 cu elementul de pe poziţia 1 etc.; 


e Al doilea câmp este opţional şi se referă la tipul obiectelor formatate. 
Poate avea una din următoarele valori: time, date, number, choice; 


e Al treilea câmp este de asemenea opţional şi se referă la stilul de for- 
matare a obiectelor. Dacă formatul stabilit la punctul anterior este time 
sau date, atunci stilul poate avea valorile: short, medium, long, 
full sau un stil de dată definit de utilizator. Dacă formatul este number, 
atunci stilul poate avea valorile: currency,percentage, integer, 
sau un stil de număr definit de utilizator. 


Iată câteva exemple de parametri: 


{0} - formateaza elementul de pe pozitia 
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0O din sir 


{0,time} - formateaza elementul de pe pozitia 
O din sir ca reprezentand timpul 
{0, date, short) - formateaza elementul de pe pozitia 


O din sir ca fiind o data 
calendaristica in format scurt 
(0, number, percent) - formateaza elementul de pe poz. 
O din sir ca fiind un procent 


Formatul choice este mai special şi îl vom descrie în continuare. Opţiunea 
choice (din lista de opţiuni pentru câmpul al doilea al unui parametru) permite 
ataşarea de mesaje unui anumit domeniu de valori. Opţiunea este utilă pentru 
că poate modifica mesajele în funcţie de anumite valori ale parametrilor. Dacă 
în exemplul nostru, valoarea parametrului ar fi fost 1 sau 0, mesajul ar fi arătat 
astfel: 


"You copied 1 files" 
sau 
"You copied 0 files" 


Prima propoziţie nu este corectă din punct de vedere gramatical (files 
este la plural) şi Java ne ajută să evităm o astfel de situaţie, prin folosirea opţi- 
unii choice. Opţiunea ne oferă posibilitatea de a modifica mesajul în funcţie 
de valoarea parametrului, astfel încât să avem următoarele mesaje: 


e dacă parametrul are valoarea 0, atunci mesajul este "You copied no 
files."; 


e dacă parametrul are valoarea 1, atunci mesajul este 
"You copied 1 file."; 


e dacă parametrul are valoarea > 1, atunci mesajul este "You copied N 
files.", unde N este un număr. 


Sintaxa opțiunii choice este descrisă în continuare. Opțiunea este specificată 
ca un set de alternative, separate prin simbolul " | ". O alternativă constă dintr-o 
limitare numerică şi un mesaj. Alternativele sunt ordonate după limitarea nu- 
merică. Limitarea reprezintă un număr double, care poate fi specificat în două 
moduri: 
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e N#, ce înseamnă că pentru toate valorile mai mari decât N, inclusiv, mesajul 
este valabil; 


e N<, ce înseamnă că pentru toate valorile mai mari decât N, exclusiv, 
mesajul este valabil. 


Folosind opţiunea choice, şablonul mesajului nostru arată astfel: 


"You copied {0,choice,0#no files|1#1 file | 
1<{0} files}" 


Deşi pare destul de complicată, la o privire mai atentă se poate obseva că 
utilizarea choice nu este chiar atât de dificilă. Şablonul ne dezvăluie că for- 
matarea se aplică parametrului O, adică elementului de pe poziția O din şirul 
de elemente, că este o formatare de tipul alegere (engl. choice) cu trei alter- 
native, separate prin două simboluri "|". Prima alternativă indică faptul că 
mesajul "no files" va fi afişat pentru valori ale parametrului > 0 şi < 1 
(conform limitării numerice a celei de a doua alternative), adică pentru valoa- 
rea 0. Asemănător, alternativa a doua indică faptul că mesajul "1 file" este 
afişat pentru o valoare a parametrului între > 1 (limitarea numerică a alternativei 
a doua) şi < 1 (limitarea numerică a alternativei a treia), adică pentru valoarea 1 
a parametrului. Alternativa a treia indică faptul că pentru valori ale parametrului 
> 1, se afişează mesajul "N files", unde N este valoarea parametrului. 

După cum se poate observa, limitările numerice ale alternativelor sunt or- 
donate crescător (0, 1, 1). 

Cu prezentarea formatării mesajelor dinamice se încheie şi ultima etapă care 
trebuie parcursă pentru a putea crea aplicaţii internaţionalizate la standarde pro- 
fesionale. Ajuns la acest nivel, programatorul Java trebuie să conştientizeze 
faptul că internaţionalizarea aplicaţiilor nu mai reprezintă o irosire a timpului, 
ci chiar o necesitate. 
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Important este să nu încetezi 


v VA 


niciodată să îţi pui întrebări. 


Albert Einstein 


E.1 Site-ul Sun Microsystems 


Pagina principală a tuturor resurselor Java este http: //java.sun.con, 
realizată de creatorii limbajului Java, unde veţi găsi informaţii complete despre 
acest limbaj. Site-ul reprezintă o colecţie impresionantă de documentaţii, tuto- 
riale, cărţi despre Java. Sugestia noastră este ca în situaţia în care aveţi nevoie 
de informaţii suplimentare despre limbajul Java, să începeţi căutarea dumnea- 
voastră aici. 

Iată câteva adrese utile în cadrul site-ului: 


e http://java.sun.com/docs - documentaţii Java; 


e http://java.sun.com/products/jdk /fag.html - răspunsuri 
la întrebări adresate frecvent; 


e http://java.sun.com/docs/books - cărţi despre limbajul Java; 


e http://java.sun.com/docs/books/tutorial- tutorialul com- 
plet al limbajului Java; 


e http://java.sun.com/j2se-pagina principală a platformei J2 SE; 


e http://java.sun.com/products - pagina de informaţii despre 
principalele produse ale Sun Microsystems. 


356 


E.2. TUTORIALE DESPRE LIMBAJUL JAVA DISPONIBILE PE INTERNET 


E.2 Tutoriale despre limbajul Java disponibile pe 
Internet 


Tutoriale Java pot fi găsite la următoarele adrese: 


e http://www.artima.Com 
e http://www.zădnet.com 


e http://directory.google.com/Top/Computers/ 
Programming/Languages/Java/ 
FAQs,_Help,_and_Tutorials/Tutorials 


e http://developer.java.sun.com/developer/ 
onlineTraining/Programming 


e http://www. javacoffeebreak.com/tutorials 


e http://webreference.com/programming/java/ 
tutorials.html 


e http://freewarejava.com 
e http://www.lnetcentral.com/online-tutorials.html 


e http://www.programmingtutorials.com/ 
tutorials.asp?id=Java 


e http://javaboutiqgue.internet.com 


E.3 Cărţi despre limbajul Java disponibile pe In- 
ternet 

Marea majoritate a site-urilor care prezintă cărţi despre limbajul Java oferă 

doar o mică descriere a acestora, pentru a crea o impresie de ansamblu celor care 


doresc să cumpere cărţile respective. Există însă şi cărți complete disponibile 
gratuit. Pentru ambele categorii vom prezenta câteva adrese utile: 


e http://java.sun.com/docs/books 


e http://www.informit.com 
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e http://gshulkin.hypermart.net/books/ 
FreeJavaBook.htm 


e http://freewarejava.com/books/index.shtml 


e http://www.better-homepage.com/java/ 
jJava-books.html 


e http://www.mindview.net,unde poate fi găsită gratuit una dintre 
cele mai bune cărţi despre Java, "Thinking in Java", scrisă de Bruce Eckel. 


E.4 Reviste online de specialitate 


Apariţia Internetului a însemnat şi o prezentare a revistelor într-un nou for- 
mat, cel electronic, mult mai accesibil decât cel standard (cel puţin din punct de 
vedere al distanţei, deoarece oricine poate citi o revistă care apare în SUA chiar 
din momentul apariţiei ei). Comunitatea IT se bucură de prezenţa a numeroase 
reviste online de prestigiu, care oferă atât informaţii generale din domeniul IT 
cât şi despre limbajul Java în special: 


http: //www. javaworld. com- liderul revistelor online care tratea- 
ză limbajul Java 


e http://www.pPcmag. Com 


e http://www.slashdot.org-revistă online care prezintă informaţii 
generale din domeniul IT şi nu numai 


e http://www.enews. Com 


e http://www.infoworld. com 


E.5 Liste de discuţii despre limbajul Java 


Pentru a comunica online (prin email) cu alţi programatori, pe tema limbaju- 
lui Java, vă recomandăm înscrierea la lista de discuţii Advanced Java, găzduită 
de Universitatea Berkeley: 
nttp://lists.xcf.berkeley.edu/mailman/listinfo/ 
advanced-java 
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E.6 Alte resurse Java 


În final, vă prezentăm o listă de site-uri unde puteţi găsi diverse alte infor- 
matii despre limbajul Java: 


e http://www. 
e http://www. 
e http://www. 


e http://www. 


ibiblio.org/javafaa 
gamelan. com 
apl.jhu.edu/ hall/java 


web-hosting.com/javalinks.html 
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